GdiFlush 関数 (wingdi.h)
GdiFlush 関数は、呼び出し元のスレッドの現在のバッチをフラッシュします。
構文
BOOL GdiFlush();
戻り値
現在のバッチ内のすべての関数が成功した場合、戻り値は 0 以外になります。
現在のバッチ内のすべての関数が成功しない場合、戻り値は 0 で、少なくとも 1 つの関数がエラーを返したことを示します。
注釈
バッチ処理では、ブール値を返す GDI 描画関数を呼び出すために必要な時間を最小限に抑えることで、描画のパフォーマンスが向上します。 システムは、現在のバッチでこれらの関数の呼び出しのパラメーターを蓄積し、次のいずれかの方法でバッチがフラッシュされたときに関数を呼び出します。
- GdiFlush 関数の呼び出し。
- GdiSetBatchLimit 関数によって設定されたバッチ制限に達するか超えています。
- バッチ処理バッファーを入力します。
- ブール値を返さない GDI 関数を呼び出します。
GdiGetBatchLimit 関数は、バッチ制限を返します。
メモ バッチ制限は、スレッドごとに個別に保持されます。 バッチ処理を完全に無効にするには、各スレッドの初期化中に GdiSetBatchLimit (1) を呼び出します。
ミューテックスを使用して GDI オブジェクトへのアクセスをシリアル化するマルチスレッド アプリケーションでは、各スレッドが GDI オブジェクトの所有権を解放するため 、GdiFlush を呼び出して GDI バッチ キューをフラッシュする必要があります。 これにより、GDI オブジェクト (デバイス コンテキスト、メタファイルなど) の競合を防ぐことができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |