GdiFlush

小甲鱼

注：本文档由 谁动了我的豆包 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

GdiFlush 函数用于刷新正在被调用的线程的当前批处理。


API 函数原型：

BOOL GdiFlush(void);

参数解析：

此函数没有任何参数。


返回值：

1. 如果在当前批处理中的全部函数都运行成功，则返回值为非 0；

2. 如果在当前批处理中的全部函数没有都运行成功，该返回值为 0，用来表明至少有一个函数返回了一个错误。


备注：

1. 分批处理能够通过减少调用返回布尔值的 GDI 绘图函数的时间来提高绘图表现。为了调用在当前批处理里的这些函数，系统会先累积一些参数然后当该批处理被以下的任何方法刷新时，系统会调用这些函数：

• 调用 GdiFlush 函数
• 当达到或者超越该批处理的极限，该极限通过 GdiSetBatchLimit 函数设置。
• 填充批处理缓冲区
• 调用任何一个不返回布尔值的 GDI 函数
  

2. GdiFlush 函数的返回值只适用于 GdiFlush 函数被调用时在批处理中的函数。当批处理被任何其它从未被提到的方法刷新时会发生错误。

3. GdiSetBatchLimit 函数返回批处理的范围。

4. 注意：批处理的极限被保留在每一个单独的线程里。想要完全禁用批处理，可以在初始化每个线程时调用 GdiSetBatchLimit(1) 函数。

5. 如果在图形批处理队列中可能有函数等待调用，一个应用应该在一个线程销毁之前调用 GdiFlush 函数。因为当一个线程销毁之后，系统就不会再去执行这样的批处理函数了。

6. 一个能够通过一个互斥变量持续访问 GDI 对象的多线程应用，必须确保通过调用 GdiFlush 函数刷新 GDI 批处理队列，用来让每一个批处理释放 GDI 对象的所有权。这样可以避免 GDI 对象（设备上下文，图元文件等等）冲突。


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Wingid.h (包含于 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。