PFND3D10DDI_CLEARRENDERTARGETVIEW Rückruffunktion (d3d10umddi.h)

  • Artikel

Die ClearRenderTargetView-Funktion löscht die angegebene Renderzielansicht, indem sie auf einen konstanten Wert festgelegt wird.

Syntax

PFND3D10DDI_CLEARRENDERTARGETVIEW Pfnd3d10ddiClearrendertargetview;

void Pfnd3d10ddiClearrendertargetview(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HRENDERTARGETVIEW unnamedParam2,
  FLOAT[4] unnamedParam3
)
{...}

Parameter

unnamedParam1

hDevice [in]

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

unnamedParam2

pColorRGBA [in]

Ein Array mit vier Elementen von Gleitkommavektoren mit einfacher Genauigkeit, die der Treiber zum Löschen einer Renderzielansicht verwendet. Arrayelement 0 ist rot (R), 1 grün (G), 2 ist blau (B) und 3 alpha (A).

unnamedParam3

hRenderTargetView [in]

Ein Handle für die zu löschende Renderzielansicht.

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 Vorgang von ClearRenderTargetView 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