GdiSetBatchLimit

GdiSetBatchLimit 関数は、呼び出しスレッドの現在のバッチに蓄積できる関数呼び出しの最大数を設定する。この上限を超えるとシステムは現在のバッチをフラッシュする。

GdiSetBatchLimit dw

dw : [int] 設定するバッチ上限を指定する。0 を指定するとデフォルトの上限が設定される。1 を指定するとバッチ処理が無効になる。

(プラグイン / モジュール : gdi32.dll)

解説

GdiSetBatchLimit
関数は、呼び出しスレッドの現在のバッチに蓄積できる関数呼び出しの最大数を設定する。この上限を超えるとシステムは現在のバッチをフラッシュする。

[戻り値]
関数が成功した場合、戻り値は以前のバッチ上限である。失敗した場合は 0 である。

[備考]
現在のバッチに蓄積できるのはブール値を返す GDI 描画関数のみで、その他の GDI
関数呼び出しは直ちにバッチをフラッシュする。バッチ上限を超えたり GdiFlush
関数を呼び出したりした場合も現在のバッチはフラッシュされる。システムが関数呼び出しを蓄積すると、バッチ内にあることを示すために関数は
TRUE を返す。システムが現在のバッチをフラッシュして 2 回目にその関数を実行すると、戻り値は関数が成功したかによって TRUE
または FALSE となる。この 2 回目の戻り値は、GdiFlush でバッチをフラッシュしたときのみ報告される。注意
バッチ上限はスレッドごとに維持される。バッチ処理を完全に無効化するには、各スレッドの初期化時に GdiSetBatchLimit(1)
を呼ぶ必要がある。

情報