小甲鱼 发表于 2016-3-28 17:10:02

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]
查看完整版本: GdiFlush