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) |