GdiSetBatchLimit

原文链接 -> 传送门

函数功能：

GdiSetBatchLimit 函数用于设置调用线程的当前批处理中，能够被调用的函数数量的最大数。每当超过这个最大数时，系统就会刷新当前批处理。


API 函数原型：

注释：_In_ 说明该参数是输入的。

DWORD GdiSetBatchLimit(
  _In_ DWORD dwLimit
);

参数解析：

返回值：

1. 如果函数运行成功，该返回值为前一个批处理的限制值；
       
2. 如果函数运行失败，该返回值为 0。


备注：

1. 在当前线程中，只有当 GDI 的绘图函数返回布尔类型值时，才能够被累积；对其它任何 GDI 函数的调用，则会立即刷新当前批处理。此外，超出批处理的限制值或者通过调用 GdiFlush 函数也将刷新当前批处理。

2. 当系统累积了一个函数调用时，该函数通过返回 TRUE 来表明它在批处理中。当系统刷新当前批处理并且第二次调用该函数时，这个返回值可能是 TRUE 也可能是 FALSE，取决于该函数是否调用成功。只有 GdiFlush 函数被用于刷新批处理时，第二个返回值才会被记录。

3. 注意：批处理的限制值被保留在每一个单独的线程里。为了想要完全禁用批处理，可以在初始化每个线程时调用 GdiSetBatchLimit(1) 函数。


需求：