PFND3D10DDI_CLEARDEPTHSTENCILVIEW回呼函式 (d3d10umddi.h)
ClearDepthStencilView 函式會清除指定的目前系結深度樣板檢視。
語法
PFND3D10DDI_CLEARDEPTHSTENCILVIEW Pfnd3d10ddiCleardepthstencilview;
void Pfnd3d10ddiCleardepthstencilview(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HDEPTHSTENCILVIEW unnamedParam2,
UINT unnamedParam3,
FLOAT unnamedParam4,
UINT8 unnamedParam5
)
{...}
參數
unnamedParam1
hDevice [in]
顯示裝置的句柄 (圖形內容) 。
unnamedParam2
hDepthStencilView [in]
要清除之深度樣板檢視的句柄。
unnamedParam3
樣板 [in]
要設定樣板的不帶正負號 8 位整數值。
unnamedParam4
深度 [in]
要設定深度的單精度浮點數向量。
unnamedParam5
旗標 [in]
值，指定要影響之緩衝區的哪些部分。 此參數必須設定為下列D3D10_DDI_CLEAR_FLAG列舉值之一。
| 值 | 意義 |
|---|---|
| D3D10_DDI_CLEAR_DEPTH (0x01L) | (Z) 深度值會限制在目前使用 Microsoft Direct3D 系結至位置零的檢視區的 ZNear 和 ZFar 範圍。 之後，Z 會再次使用 Direct3D 再次固定在目前系結深度樣板檢視的可表示範圍。 |
| D3D10_DDI_CLEAR_STENCIL (0x02L) | 清除樣板值。 |
傳回值
無
備註
驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。
浮點規則適用於 ClearDepthStencilView 函式。
除了D3DDDIERR_DEVICEREMOVED之外，驅動程式不應該發生任何錯誤。 因此，如果驅動程式通過任何錯誤，但除了D3DDDIERR_DEVICEREMOVED之外，在 pfnSetErrorCb 函式的呼叫中，Direct3D 運行時間會判斷錯誤很重要。 即使裝置已移除，驅動程式也不需要傳回D3DDDIERR_DEVICEREMOVED;不過，如果裝置移除干擾 了 ClearDepthStencilView (作業，通常不應該) 發生，驅動程式可以傳回D3DDDIERR_DEVICEREMOVED。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | 桌面 |
| 標頭 | d3d10umddi.h (include D3d10umddi.h) |