GdiGetBatchLimit 函式 (wingdi.h)

GdiGetBatchLimit 函式會傳回可在呼叫線程目前批次中累積的函數調用數目上限。每當超過此限制時，系統會排清目前的批次。

Syntax

DWORD GdiGetBatchLimit();

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

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

批次限制是使用 GdiSetBatchLimit 函式來設定。將限制設定為 1 會有效地停用批處理。

只能批處理傳回布爾值的 GDI 繪圖函式;呼叫任何其他 GDI 函式會立即清除目前的批次。超過批次限制或呼叫 GdiFlush 函式也會排清目前的批次。

當系統批處理函數調用時，函式會傳回 TRUE。只有在使用 GdiFlush 來排清批次時，才會報告函式的實際傳回值。

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

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