PFND3DDDI_DESTROYDEVICE Rückruffunktion (d3dumddi.h)
Die DestroyDevice-Funktion zerstört einen Grafikkontext.
Syntax
PFND3DDDI_DESTROYDEVICE Pfnd3dddiDestroydevice;
HRESULT Pfnd3dddiDestroydevice(
HANDLE hDevice
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext), das zerstört wird.
Rückgabewert
DestroyDevice gibt S_OK oder ein entsprechendes Fehlerergebnis zurück.
Bemerkungen
Der Treiber sollte alle Ressourcen freigeben, die es für das Gerät zugewiesen hat, und alle internen Tracking-Datenstrukturen bereinigen.
Bevor der Treiber die pfnDeallocateCb--Funktion aufruft, um Zuordnungen freizugeben, muss der Treiber sicherstellen, dass die Zuordnungen entsperrt sind. Anders ausgedrückt: In der Lebensdauer eines Geräts muss jeder Aufruf der pfnLockCb--Funktion zum Sperren einer Zuordnung mit einem Aufruf der pfnUnlockCb-Funktion gekoppelt werden, um die Zuordnung zu entsperren. In einem Aufruf von pfnUnlockCbkann der Treiber jedoch mehrere Zuordnungen entsperren, die jeweils in separaten pfnLockCb--Aufrufen zugeordnet wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |