PDD_SURFCB_FLIP Rückruffunktion (ddrawint.h)
Die DdFlip-Rückruffunktion bewirkt, dass der der Zieloberfläche zugeordnete Oberflächenspeicher zur primären Oberfläche und die aktuelle Oberfläche zur nicht primären Oberfläche wird.
Syntax
PDD_SURFCB_FLIP PddSurfcbFlip;
DWORD PddSurfcbFlip(
PDD_FLIPDATA unnamedParam1
)
{...}
Parameter
unnamedParam1
Zeigt auf eine DD_FLIPDATA-Struktur , die die zum Ausführen des Umdrehens erforderlichen Informationen enthält.
Rückgabewert
DdFlip gibt einen der folgenden Rückrufcodes zurück:
Hinweise
DdFlip ermöglicht es einem Anzeigetreiber, Multibuffering durchzuführen. DirectDraw-Treiber müssen diese Funktion implementieren.
Der Treiber sollte seine Surface-Zeiger aktualisieren, sodass der nächste Frame auf die Oberfläche geschrieben wird, auf die das lpSurfTarg-Element der DD_FLIPDATA Struktur an lpFlip-Punkten geschrieben wird. Wenn eine vorherige Flip-Anforderung noch aussteht, sollte der Treiber den Aufruf fehlschlagen, indem er den ddRVal-Member von DD_FLIPDATA auf DDERR_WASSTILLDRAWING festlegt und DDHAL_DRIVER_HANDLED zurückgibt. Der Treiber sollte sicherstellen, dass sich die Scanzeile nicht in der vertikalen Leerzeile befindet, bevor sie das Umdrehen ausführt. DdFlip wirkt sich nicht auf die tatsächliche Anzeige der Videodaten aus.
Wenn die Hardware des Treibers Überlagerungen oder Texturen unterstützt, sollte DdFlip alle erforderlichen Überprüfungen basierend auf dem Oberflächentyp durchführen, bevor der Flip ausgeführt wird.
Anforderungen
| Zielplattform | Desktop |
| Kopfzeile | ddrawint.h (include Winddi.h) |