GdiSetBatchLimit 函数 (wingdi.h)
GdiSetBatchLimit 函数设置可在调用线程的当前批处理中累积的最大函数调用数。 每当超过此限制时,系统会刷新当前批。
语法
DWORD GdiSetBatchLimit(
[in] DWORD dw
);
参数
[in] dw
指定要设置的批限制。 如果值为 0,则设置默认限制。 如果值为 1,则禁用批处理。
返回值
如果函数成功,则返回值为以前的批限制。
如果函数失败,则返回值为零。
注解
当前批中只能累积返回布尔值的 GDI 绘图函数;调用任何其他 GDI 函数会立即刷新当前批处理。 超过批限制或调用 GdiFlush 函数也会刷新当前批。
当系统累积函数调用时,函数返回 TRUE 以指示它位于批处理中。 当系统刷新当前批处理并第二次执行函数时,返回值为 TRUE 或 FALSE,具体取决于函数是否成功。 仅当 使用 GdiFlush 刷新批处理时,才会报告第二个返回值。
注意 单独为每个线程维护批限制。 若要完全禁用批处理,请在初始化每个线程期间 (1) 调用 GdiSetBatchLimit 。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | wingdi.h (包括 Windows.h) |
Library | Gdi32.lib |
DLL | Gdi32.dll |