Freigeben über


PFND3D10DDI_DESTROYDEVICE Rückruffunktion (d3d10umddi.h)

Die Funktion DestroyDevice(D3D10) zerstört das angegebene Geräteobjekt.

Syntax

PFND3D10DDI_DESTROYDEVICE Pfnd3d10ddiDestroydevice;

void Pfnd3d10ddiDestroydevice(
  D3D10DDI_HDEVICE unnamedParam1
)
{...}

Parameter

unnamedParam1

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext). Die Microsoft Direct3D-Runtime gibt den Speicherbereich frei, den sie zuvor für das Objekt zugewiesen hat. Daher kann der Treiber nicht mehr auf diese Speicherregion zugreifen.

Rückgabewert

Keine

Bemerkungen

Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.

Bevor die Direct3D-Runtime DestroyDevice(D3D10) aufruft, zerstört sie alle untergeordneten Objekte des Anzeigegeräts (Mischzustand, Ressourcen usw.).

Für den Treiber sollte kein Fehler auftreten, mit Ausnahme von D3DDDIERR_DEVICEREMOVED. Wenn der Treiber bei einem Aufruf der PfnSetErrorCb-Funktion einen Fehler mit Ausnahme von D3DDDIERR_DEVICEREMOVED übergibt, ermittelt die Direct3D-Runtime daher, dass der Fehler kritisch ist. Selbst wenn das Gerät entfernt wurde, muss der Treiber nicht D3DDDIERR_DEVICEREMOVED zurückgeben. Wenn die Geräteentfernung jedoch den Betrieb von DestroyDevice(D3D10) beeinträchtigt hat (was normalerweise nicht geschehen sollte), kann der Treiber D3DDDIERR_DEVICEREMOVED zurückgeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile d3d10umddi.h (einschließlich D3d10umddi.h)

Weitere Informationen

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb