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.
Die GdiGetBatchLimit-Funktion gibt den Batchgrenzwert zurück.
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 |