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.

Hinweise

Der Treiber sollte alle Ressourcen freigeben, die er für das Gerät zugewiesen hat, und sauber alle internen Nachverfolgungsdatenstrukturen.

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 pfnUnlockCb kann der Treiber jedoch mehrere Zuordnungen entsperren, die jeweils in separaten pfnLockCb-Aufrufen zugeordnet wurden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

CreateDevice

pfnDeallocateCb

pfnLockCb

pfnUnlockCb