Freigeben über


GdiFlush-Funktion (wingdi.h)

Die GdiFlush-Funktion leert den aktuellen Batch des aufrufenden Threads.

Syntax

BOOL GdiFlush();

Rückgabewert

Wenn alle Funktionen im aktuellen Batch erfolgreich sind, ist der Rückgabewert ungleich null.

Wenn nicht alle Funktionen im aktuellen Batch erfolgreich sind, ist der Rückgabewert null, was angibt, dass mindestens eine Funktion einen Fehler zurückgegeben hat.

Hinweise

Batchverarbeitung verbessert die Zeichnungsleistung, indem der Zeitaufwand für das Aufrufen von GDI-Zeichnungsfunktionen, die boolesche Werte zurückgeben, minimiert wird. Das System sammelt die Parameter für Aufrufe dieser Funktionen im aktuellen Batch und ruft dann die Funktionen auf, wenn der Batch mit einer der folgenden Methoden geleert wird:

  • Aufrufen der GdiFlush-Funktion .
  • Erreichen oder Überschreiten des von der GdiSetBatchLimit-Funktion festgelegten Batchgrenzwerts.
  • Auffüllen der Batchverarbeitungspuffer.
  • Aufrufen einer GDI-Funktion, die keinen booleschen Wert zurückgibt.
Der Rückgabewert für GdiFlush gilt nur für die Funktionen im Batch zum Zeitpunkt des GdiFlush-Aufrufs . Fehler, die auftreten, wenn der Batch auf andere Weise geleert wird, werden nie gemeldet.

Die GdiGetBatchLimit-Funktion gibt den Batchgrenzwert zurück.

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.
 
Eine Anwendung sollte GdiFlush aufrufen, bevor ein Thread verschwindet, wenn es möglich ist, dass in der Grafikbatchwarteschlange Funktionsaufrufe ausstehen. Das System führt solche Batchfunktionen nicht aus, wenn ein Thread entfernt wird.

Eine Multithreadanwendung, die den Zugriff auf GDI-Objekte mit einem Mutex serialisiert, muss sicherstellen, dass die GDI-Batchwarteschlange geleert wird, indem GdiFlush aufgerufen wird, während jeder Thread den Besitz des GDI-Objekts freigibt. Dadurch werden Kollisionen der GDI-Objekte (Gerätekontexte, Metadateien usw.) verhindert.

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 (windows.h einschließen)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

GdiGetBatchLimit

GdiSetBatchLimit

Mal- und Zeichenfunktionen

Übersicht über Das Malen und Zeichnen