GdiSetBatchLimit 函式 (wingdi.h)

GdiSetBatchLimit函式會設定可在呼叫執行緒目前批次中累積的函式呼叫數目上限。每當超過此限制時，系統會排清目前的批次。

語法

DWORD GdiSetBatchLimit(
  [in] DWORD dw
);

[in] dw

指定要設定的批次限制。值為 0 會設定預設限制。值為 1 會停用批次處理。

如果函式成功，則傳回值為先前的批次限制。

如果此函式失敗，則傳回值為零。

只有傳回布林值的 GDI 繪圖函式才能在目前的批次中累積;呼叫任何其他 GDI 函式會立即清除目前的批次。超過批次限制或呼叫 GdiFlush 函式也會排清目前的批次。

當系統累積函式呼叫時，函式會傳回 TRUE ，以指出它位於批次中。當系統排清目前的批次並第二次執行函式時，傳回值會是 TRUE 或 FALSE，視函式是否成功而定。只有在使用 GdiFlush 來排清批次時，才會報告第二個傳回值。

注意每個執行緒會分別維護批次限制。若要完全停用批次處理，請在初始化每個執行緒期間呼叫 GdiSetBatchLimit (1) 。


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll