NtGdiDdFlip-Funktion

[Diese Funktion kann bei jeder Betriebssystemrevision geändert werden. Verwenden Sie stattdessen Microsoft DirectDraw und Microsoft Direct3DAPIs. diese APIs isolieren Anwendungen vor solchen Betriebssystemänderungen und verbergen viele andere Schwierigkeiten bei der direkten Interaktion mit Anzeigetreibern.]

Bewirkt, dass der dem Ziel zugeordnete Oberflächenspeicher und die aktuellen Oberflächen ausgetauscht werden.

Syntax

DWORD APIENTRY NtGdiDdFlip(
  _In_    HANDLE       hSurfaceCurrent,
  _In_    HANDLE       hSurfaceTarget,
  _In_    HANDLE       hSurfaceCurrentLeft,
  _In_    HANDLE       hSurfaceTargetLeft,
  _Inout_ PDD_FLIPDATA puFlipData
);

Parameter

hSurfaceCurrent [ In]

Handle für die DD _ SURFACE _ LOCAL-Struktur, die die aktuelle Oberfläche beschreibt.

hSurfaceTarget [ In]

Handle für die DD _ SURFACE _ LOCAL-Struktur, die die Zieloberfläche beschreibt, d. h. die Oberfläche, auf die sich der Treiber drehen soll.

hSurfaceCurrentLeft [ In]

Handle für die DD _ SURFACE _ LOCAL-Struktur, die die aktuelle linke Oberfläche beschreibt.

hSurfaceTargetLeft [ In]

Handle für die DD _ SURFACE _ LOCAL-Struktur, die die linke Zieloberfläche beschreibt, auf die gekippt werden soll.

puFlipData [ in, out]

Zeiger auf eine _ DD-FLIPDATA-Struktur, die die informationen enthält, die zum Ausführen des Flips erforderlich sind.

Rückgabewert

NtGdiDdFlip gibt einen der folgenden Rückrufcodes zurück.

Rückgabecode Beschreibung
BEHANDELTER _ DDHAL-TREIBER _
Der Treiber hat den Vorgang ausgeführt und einen gültigen Rückgabecode für diesen Vorgang zurückgegeben. Wenn dieser Code DD _ OK ist, wird DirectDraw oder Direct3D mit der Funktion fortgesetzt. Andernfalls gibt DirectDraw oder Direct3D den vom Treiber bereitgestellten Fehlercode zurück und bricht die Funktion ab.
_DDHAL-TREIBER _ NICHT BEHANDELT
Der Treiber hat keinen Kommentar zum angeforderten Vorgang. Wenn der Treiber einen bestimmten Rückruf implementiert haben muss, meldet DirectDraw oder Direct3D eine Fehlerbedingung. Andernfalls verarbeitet DirectDraw oder Direct3D den Vorgang so, als ob der Treiberrückruf nicht durch Ausführen der geräteunabhängigen DirectDraw- oder Direct3D-Implementierung definiert worden wäre.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Ntgdi.h

Weitere Informationen

Grafik– Clientunterstützung auf niedriger Ebene