共用方式為


GdiSetBatchLimit 函式 (wingdi.h)

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

語法

DWORD GdiSetBatchLimit(
  [in] DWORD dw
);

參數

[in] dw

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

傳回值

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

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

備註

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

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

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

規格需求

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

另請參閱

GdiFlush

GdiGetBatchLimit

繪製和繪圖函式

繪製和繪圖概觀