GdiFlush

Declare Function Api_GdiFlush& Lib "gdi32" Alias "GdiFlush" ()

Declare Function GdiFlush Lib "gdi32" () As Long

呼び出し側スレッドの現在のバッチをフラッシュする。

パラメータ
    パラメータはなし。

戻り値
    現在のバッチに含まれるすべての関数が成功すると、0 以外の値が返る。
    現在のバッチに含まれるすべての関数が成功しないときは、0 が返る。

    この戻り値は、少なくとも 1 つの関数がエラーを返したことを示す。

解説
    バッチ処理は、ブール値を返す GDI 描画関数を呼び出すために必要な時間を最小限にすることによって、描画パフォーマンスを向上させ

    る。システムは、現在のバッチに含まれる関数群を呼び出すためのパラメータを蓄積し、バッチが次のいずれかによってフラッシュされたとき

    にそれぞれの関数を呼び出す。
    ・GdiFlush 関数が呼び出された
    ・GdiSetBatchLimit 関数で設定したバッチの上限に到達したか、その上限を超えた
    ・バッチ処理化バッファがいっぱいになった
    ・ブール値を返さない GDI 関数が呼び出された
    GdiFlush 関数の戻り値は、GdiFlush 関数の呼び出し時にバッチ内の関数にだけ適用される。

    バッチがほかの条件でフラッシュされたときに発生するエラーが報告されることはない。
    バッチの上限を取得するには、GdiGetBatchLimit 関数を使う。