NtGdiDdUnattachSurface-Funktion

Artikel
06/12/2023

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

Entfernt eine mit NtGdiDdAttachSurface erstellte Anlage zwischen zwei Surface-Objekten im Kernelmodus.

Syntax

VOID APIENTRY NtGdiDdUnattachSurface(
  _In_ HANDLE hSurface,
  _In_ HANDLE hSurfaceAttached
);

Parameter

hSurface [in]: Das Surface-Objekt im Kernelmodus, das als hSurfaceFrom-Parameter an NtGdiDdAttachSurface übergeben wurde.
hSurfaceAttached [in]: Das Surface-Objekt im Kernelmodus, das als hSurfaceTo-Parameter an NtGdiDdAttachSurface übergeben wurde

Rückgabewert

NtGdiDdUnattachSurface 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, 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_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 ob der Treiberrückruf nicht durch Ausführen der geräteunabhängigen DirectDraw- oder Direct3D-Implementierung definiert worden wäre.

Bemerkungen

Es wird empfohlen, dass Anwendungen die DirectDraw-API verwenden, die Oberflächenanhänge auf höherer Ebene verarbeitet.

Es ist nicht notwendig, diese Funktion aufzurufen, da der Kernel automatisch alle Anlagen zerstört, wenn NtGdiDdDestroySurface aufgerufen wird.

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

Unterstützung des Grafikclients auf niedriger Ebene

Freigeben über