語法
參數
DepthStencilView [in]類型:D3D12_CPU_DESCRIPTOR_HANDLE 描述 CPU 描述元控制代碼,代表要清除之深度樣板的堆積開頭。 ClearFlags [in]
類型:D3D12_CLEAR_FLAGS D3D12_CLEAR_FLAGS 值的組合,以位元 OR 運算結合。產生的值會識別要清除的資料類型 (深度緩衝區、樣板緩衝區或兩者)。 Depth [in]
類型:FLOAT 用來清除深度緩衝區的值。此值會限制在 0 與 1 之間。 Stencil [in]
類型:UINT8 用來清除樣板緩衝區的值。 NumRects [in]
類型:UINT pRects 參數所指定之陣列中的矩形數目。 pRects [in]
類型:const D3D12_RECT* D3D12_RECT 結構的陣列,代表資源檢視中要清除的矩形。如果為 NULL,ClearDepthStencilView 會清除整個資源檢視。
傳回值
類型:void 無。備註
只有直接命令清單和套件組合命令清單支援此作業。 ClearDepthStencilView 可用來初始化別名相同堆積記憶體的資源。如需詳細資訊,請參閱 CreatePlacedResource。執行階段驗證
對於浮點輸入,執行階段會將非正規化值設定為 0 (同時保留 NAN)。 驗證失敗會導致對 Close 的呼叫傳回 E_INVALIDARG。偵錯層
如果輸入色彩為非正規化,偵錯層會發出錯誤。 如果檢視所參考的子資源不處於適當的狀態,偵錯層會發出錯誤。 對於 ClearDepthStencilView,狀態必須為 D3D12_RESOURCE_STATE_DEPTH_WRITE。範例
D3D12Bundles 範例使用 ID3D12GraphicsCommandList::ClearDepthStencilView 的方式如下:需求
標頭: d3d12_xs.h 或 d3d12_x.h程式庫: d3d12_xs.lib 或 d3d12_x.lib
支援的平台: XBOX Series 主機與 XBOX One 系列
