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