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 |