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