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)所有,转载请注明来源。
页:
[1]