PFND3D10DDI_CLEARDEPTHSTENCILVIEW Rückruffunktion (d3d10umddi.h)

Die ClearDepthStencilView-Funktion löscht die angegebene aktuell gebundene Tiefenschablonenansicht.

Syntax

PFND3D10DDI_CLEARDEPTHSTENCILVIEW Pfnd3d10ddiCleardepthstencilview;

void Pfnd3d10ddiCleardepthstencilview(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HDEPTHSTENCILVIEW unnamedParam2,
  UINT unnamedParam3,
  FLOAT unnamedParam4,
  UINT8 unnamedParam5
)
{...}

Parameter

unnamedParam1

hDevice [in]

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

unnamedParam2

hDepthStencilView [in]

Ein Ziehpunkt für die Tiefenschablonenansicht, die gelöscht werden soll.

unnamedParam3

Schablone [in]

Ein ganzzahliger 8-Bit-Wert ohne Vorzeichen, auf den die Schablone festgelegt werden soll.

unnamedParam4

Tiefe [in]

Ein Gleitkommavektor mit einfacher Genauigkeit, auf den die Tiefe festgelegt werden soll.

unnamedParam5

Flaggen [in]

Ein -Wert, der angibt, auf welche Teile des Puffers sich auswirken soll. Dieser Parameter muss auf einen der folgenden Werte aus der D3D10_DDI_CLEAR_FLAG-Enumeration festgelegt werden.

Wert	Bedeutung
D3D10_DDI_CLEAR_DEPTH (0x01L)	Der Tiefenwert (Z) wird mithilfe von Microsoft Direct3D an den Bereich ZNear und ZFar des Viewports geklemmt, der derzeit an Slot 0 gebunden ist. Anschließend wird Z erneut mithilfe von Direct3D an den darstellbaren Bereich der aktuell gebundenen Tiefenschablonenansicht geklemmt.
D3D10_DDI_CLEAR_STENCIL (0x02L)	Der Schablonenwert wird gelöscht.

Rückgabewert

Keine

Bemerkungen

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

Gleitkommaregeln gelten für die ClearDepthStencilView-Funktion .

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