PFND3D10DDI_DESTROYRENDERTARGETVIEW Rückruffunktion (d3d10umddi.h)

Die DestroyRenderTargetView-Funktion zerstört das angegebene Renderzielansichtsobjekt. Das Renderzielansichtsobjekt kann nur zerstört werden, wenn es derzeit nicht an ein Anzeigegerät gebunden ist.

Syntax

PFND3D10DDI_DESTROYRENDERTARGETVIEW Pfnd3d10ddiDestroyrendertargetview;

void Pfnd3d10ddiDestroyrendertargetview(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HRENDERTARGETVIEW unnamedParam2
)
{...}

Parameter

unnamedParam1

hDevice [in]

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

hRenderTargetView [in]

Ein Handle für die privaten Daten des Treibers, damit das Renderzielansichtsobjekt zerstört werden soll. Die Microsoft Direct3D-Runtime gibt den Speicherbereich frei, den sie zuvor für das Objekt zugewiesen hat. Daher kann der Treiber nicht mehr auf diesen Speicherbereich zugreifen.

Rückgabewert

Keine

Bemerkungen

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

Für den Treiber sollte mit Ausnahme von D3DDDIERR_DEVICEREMOVED kein Fehler auftreten. 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 DestroyRenderTargetView beeinträchtigt (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 (include D3d10umddi.h)

Weitere Informationen

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb