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.

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

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

GdiGetBatchLimit

Mal- und Zeichenfunktionen

Übersicht über Malerei und Zeichnung