GdiSetBatchLimit-Funktion (wingdi.h)
Die GdiSetBatchLimit-Funktion legt die maximale Anzahl von Funktionsaufrufen fest, die im aktuellen Batch des aufrufenden Threads akkumuliert werden können. Das System löscht den aktuellen Batch, wenn dieser Grenzwert überschritten wird.
Syntax
DWORD GdiSetBatchLimit(
[in] DWORD dw
);
Parameter
[in] dw
Gibt das festzulegende Batchlimit an. Der Wert 0 legt das Standardlimit fest. Der Wert 1 deaktiviert die Batchverarbeitung.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert das vorherige Batchlimit.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Nur GDI-Zeichenfunktionen, die boolesche Werte zurückgeben, können im aktuellen Batch akkumuliert werden. ruft alle anderen GDI-Funktionen sofort auf, um den aktuellen Batch zu leeren. Das Überschreiten des Batchlimits oder das Aufrufen der GdiFlush-Funktion löscht auch den aktuellen Batch.
Wenn das System einen Funktionsaufruf akkumuliert, gibt die Funktion TRUE zurück, um anzugeben, dass sie sich im Batch befindet. Wenn das System den aktuellen Batch leert und die Funktion zum zweiten Mal ausführt, lautet der Rückgabewert entweder TRUE oder FALSE, je nachdem, ob die Funktion erfolgreich ist. Dieser zweite Rückgabewert wird nur gemeldet, wenn GdiFlush zum Leeren des Batches verwendet wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (einschließlich Windows.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |