GdiSetBatchLimit 函数 (wingdi.h)

GdiSetBatchLimit 函数设置可在调用线程的当前批处理中累积的最大函数调用数。 每当超过此限制时,系统会刷新当前批。

语法

DWORD GdiSetBatchLimit(
  [in] DWORD dw
);

参数

[in] dw

指定要设置的批限制。 如果值为 0,则设置默认限制。 如果值为 1,则禁用批处理。

返回值

如果函数成功,则返回值为以前的批限制。

如果函数失败,则返回值为零。

注解

当前批中只能累积返回布尔值的 GDI 绘图函数;调用任何其他 GDI 函数会立即刷新当前批处理。 超过批限制或调用 GdiFlush 函数也会刷新当前批。

当系统累积函数调用时,函数返回 TRUE 以指示它位于批处理中。 当系统刷新当前批处理并第二次执行函数时,返回值为 TRUEFALSE,具体取决于函数是否成功。 仅当 使用 GdiFlush 刷新批处理时,才会报告第二个返回值。

注意 单独为每个线程维护批限制。 若要完全禁用批处理,请在初始化每个线程期间 (1) 调用 GdiSetBatchLimit
 

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

GdiFlush

GdiGetBatchLimit

绘制和绘制函数

绘画和绘图概述