小甲鱼 发表于 2016-9-16 04:02:59

GdiSetBatchLimit

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

原文链接 -> 传送门

函数功能:

GdiSetBatchLimit 函数用于设置调用线程的当前批处理中,能够被调用的函数数量的最大数。每当超过这个最大数时,系统就会刷新当前批处理。


API 函数原型:

注释:_In_ 说明该参数是输入的。
DWORD GdiSetBatchLimit(
_In_ DWORD dwLimit
);

参数解析:


参数 含义
dwLimit 1. 指定要被设置的批处理限制值

2. 当这个值为 0 时,设置为默认极限;当这个值为 1 时,则禁用批处理


返回值:

1. 如果函数运行成功,该返回值为前一个批处理的限制值;
       
2. 如果函数运行失败,该返回值为 0。


备注:

1. 在当前线程中,只有当 GDI 的绘图函数返回布尔类型值时,才能够被累积;对其它任何 GDI 函数的调用,则会立即刷新当前批处理。此外,超出批处理的限制值或者通过调用 GdiFlush 函数也将刷新当前批处理。

2. 当系统累积了一个函数调用时,该函数通过返回 TRUE 来表明它在批处理中。当系统刷新当前批处理并且第二次调用该函数时,这个返回值可能是 TRUE 也可能是 FALSE,取决于该函数是否调用成功。只有 GdiFlush 函数被用于刷新批处理时,第二个返回值才会被记录。

3. 注意:批处理的限制值被保留在每一个单独的线程里。为了想要完全禁用批处理,可以在初始化每个线程时调用 GdiSetBatchLimit(1) 函数。


需求:


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