GdiGetBatchLimit-Funktion (wingdi.h)

Die GdiGetBatchLimit-Funktion gibt die maximale Anzahl von Funktionsaufrufen zurück, 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 GdiGetBatchLimit();

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Batchlimit.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Das Batchlimit wird mithilfe der Funktion GdiSetBatchLimit festgelegt. Durch Festlegen des Grenzwerts auf 1 wird die Batchverarbeitung effektiv deaktiviert.

Nur GDI-Zeichenfunktionen, die boolesche Werte zurückgeben, können batchiert 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 batchiert, gibt die Funktion TRUE zurück. Der tatsächliche Rückgabewert für die Funktion wird nur gemeldet, wenn GdiFlush zum Leeren des Batches verwendet wird.

Hinweis Das Batchlimit wird für jeden Thread separat beibehalten. Um die Batchverarbeitung vollständig zu deaktivieren, rufen Sie GdiSetBatchLimit (1) während der Initialisierung jedes Threads auf.

 

Anforderungen

Anforderung	Wert
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

Weitere Informationen

GdiFlush

GdiSetBatchLimit

Mal- und Zeichenfunktionen

Übersicht über Malerei und Zeichnung