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）所有，转载请注明来源。