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]