GdiFlush 函式 (wingdi.h)

GdiFlush 函式會排清呼叫線程的目前批次。

Syntax

BOOL GdiFlush();

如果目前批次中的所有函式都成功，則傳回值為非零。

如果目前批次中的所有函式都成功，則傳回值為零，表示至少有一個函式傳回錯誤。

批處理可藉由將呼叫傳回布爾值之 GDI 繪圖函式所需的時間量降到最低，藉此增強繪圖效能。系統會累積目前批次中這些函式呼叫的參數，然後在批次排清下列任何方法時呼叫函式：

GdiFlush 的傳回值僅適用於呼叫 GdiFlush 時批次中的函式。永遠不會報告任何其他方法排清批次時所發生的錯誤。

GdiGetBatchLimit 函式會傳回批次限制。

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

如果圖形批次佇列中有擱置的函式呼叫，應用程式應該在線程消失之前呼叫 GdiFlush 。當線程消失時，系統不會執行這類批處理函式。

使用 mutex 串行化 GDI 物件的存取權的多線程應用程式，必須藉由呼叫 GdiFlush 來清除 GDI 批次佇列，因為每個線程都會釋放 GDI 物件的擁有權。這可防止 GDI 物件的衝突 (裝置內容、元檔等等) 。