NtGdiDdDestroySurface-Funktion

  • Artikel

[Diese Funktion kann sich mit jeder Betriebssystemrevision ändern. Verwenden Sie stattdessen die DirectDraw- und Microsoft Direct3DAPIs. diese APIs isolieren Anwendungen vor solchen Betriebssystemänderungen und verbergen viele andere Schwierigkeiten, die bei der direkten Interaktion mit Anzeigetreibern auftreten.]

Zerstört ein zuvor zugewiesenes Microsoft DirectDraw-Surface-Objekt im Kernelmodus.

Syntax

DWORD APIENTRY NtGdiDdDestroySurface(
  _In_ HANDLE hSurface,
  _In_ BOOL   bRealDestroy
);

Parameter

hSurface [in]

Behandeln Sie das zuvor zugewiesene Oberflächenobjekt im Kernelmodus.

bRealDestroy [in]

Gibt an, wie die Oberfläche zerstört werden soll. Kann einer der folgenden Werte sein.

(TRUE)

Zerstören Sie die Oberfläche, und geben Sie den Videospeicher frei.

(FALSE)

Geben Sie den Videospeicher frei, aber lassen Sie die Oberfläche in einem nicht initialisierten Zustand.

Rückgabewert

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

Rückgabecode Beschreibung
DDHAL_DRIVER_HANDLED
 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, fährt DirectDraw oder Direct3D mit der Funktion fort. Andernfalls gibt DirectDraw oder Direct3D den vom Treiber bereitgestellten Fehlercode zurück und bricht die Funktion ab.
DDHAL_DRIVER_NOTHANDLED
 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 wäre der Treiberrückruf nicht durch Ausführen der geräteunabhängigen DirectDraw- oder Direct3D-Implementierung definiert worden.

 

Bemerkungen

Es wird empfohlen, dass Anwendungen die DirectDraw- und Direct3D-APIs verwenden, um Oberflächen anstelle dieser Funktion zu erstellen und zu zerstören.

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

Siehe auch

Low-Level-Clientunterstützung für Grafiken