Skip to main content
清除深度樣板資源。

語法

參數

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 的方式如下:
D3D12Multithreading 範例使用 ID3D12GraphicsCommandList::ClearDepthStencilView 的方式如下:
請參閱 Direct3D 12 參考中的範例程式碼。

需求

標頭: d3d12_xs.h 或 d3d12_x.h
程式庫: d3d12_xs.lib 或 d3d12_x.lib
支援的平台: XBOX Series 主機與 XBOX One 系列

另請參閱

ID3D12GraphicsCommandList
Last modified on October 6, 2026