GdiGetBatchLimit 関数 (wingdi.h)

GdiGetBatchLimit 関数は、呼び出し元スレッドの現在のバッチに累積できる関数呼び出しの最大数を返します。この制限を超えると、システムは現在のバッチをフラッシュします。

構文

DWORD GdiGetBatchLimit();

関数が成功した場合、戻り値はバッチ制限です。

関数が失敗した場合は、0 を返します。

バッチ制限は、 GdiSetBatchLimit 関数を使用して設定します。制限を 1 に設定すると、バッチ処理が実質的に無効になります。

ブール値を返す GDI 描画関数のみをバッチ処理できます。他の GDI 関数への呼び出しは、現在のバッチを直ちにフラッシュします。バッチ制限を超えるか、 GdiFlush 関数を呼び出すと、現在のバッチもフラッシュされます。

システムが関数呼び出しをバッチ処理すると、関数は TRUE を返します。関数の実際の戻り値は、 GdiFlush を使用してバッチをフラッシュする場合にのみ報告されます。

メモバッチ制限は、スレッドごとに個別に保持されます。バッチ処理を完全に無効にするには、各スレッドの初期化中に GdiSetBatchLimit (1) を呼び出します。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll