> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_DEPTH_STENCIL_VIEW_DESC

> 描述可從深度樣板檢視存取之紋理的子資源。

描述可從深度樣板檢視存取之紋理的子資源。

## 語法

```cpp theme={null}
typedef struct D3D12_DEPTH_STENCIL_VIEW_DESC
{
    DXGI_FORMAT Format;
    D3D12_DSV_DIMENSION ViewDimension;
    D3D12_DSV_FLAGS Flags;
    D3D12_TEX1D_DSV Texture1D;
    D3D12_TEX1D_ARRAY_DSV Texture1DArray;
    D3D12_TEX2D_DSV Texture2D;
    D3D12_TEX2D_ARRAY_DSV Texture2DArray;
    D3D12_TEX2DMS_DSV Texture2DMS;
    D3D12_TEX2DMS_ARRAY_DSV Texture2DMSArray;
} D3D12_DEPTH_STENCIL_VIEW_DESC
```

### 成員

*Format*\
類型：DXGI\_FORMAT

[DXGI\_FORMAT](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format) 類型的值，指定檢視格式。如需允許的格式，請參閱＜備註＞。

*ViewDimension*\
類型：D3D12\_DSV\_DIMENSION

[D3D12\_DSV\_DIMENSION](/zh-TW/reference/graphics/d3d12/enums/d3d12_dsv_dimension_public) 類型的值，指定存取深度樣板資源的方式。此成員也會決定在下列等位中要使用哪一個 \_DSV。

*Flags*\
類型：D3D12\_DSV\_FLAGS

使用位元 OR 運算組合的 [D3D12\_DSV\_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_dsv_flags_public) 列舉常數組合。
產生的值會指定紋理是否為唯讀。
傳遞 0 以指定其不是唯讀；否則，請傳遞 **D3D12\_DSV\_FLAGS** 列舉類型的一或多個成員。

*Texture1D*\
類型：D3D12\_TEX1D\_DSV

[D3D12\_TEX1D\_DSV](/zh-TW/reference/graphics/d3d12/structs/d3d12_tex1d_dsv_public) 結構，指定 1D 紋理子資源。

*Texture1DArray*\
類型：D3D12\_TEX1D\_ARRAY\_DSV

[D3D12\_TEX1D\_ARRAY\_DSV](/zh-TW/reference/graphics/d3d12/structs/d3d12_tex1d_array_dsv_public) 結構，指定 1D 紋理子資源的陣列。

*Texture2D*\
類型：D3D12\_TEX2D\_DSV

[D3D12\_TEX2D\_DSV](/zh-TW/reference/graphics/d3d12/structs/d3d12_tex2d_dsv_public) 結構，指定 2D 紋理子資源。

*Texture2DArray*\
類型：D3D12\_TEX2D\_ARRAY\_DSV

[D3D12\_TEX2D\_ARRAY\_DSV](/zh-TW/reference/graphics/d3d12/structs/d3d12_tex2d_array_dsv_public) 結構，指定 2D 紋理子資源的陣列。

*Texture2DMS*\
類型：D3D12\_TEX2DMS\_DSV

[D3D12\_TEX2DMS\_DSV](/zh-TW/reference/graphics/d3d12/structs/d3d12_tex2dms_dsv_public) 結構，指定多重取樣 2D 紋理。

*Texture2DMSArray*\
類型：D3D12\_TEX2DMS\_ARRAY\_DSV

[D3D12\_TEX2DMS\_ARRAY\_DSV](/zh-TW/reference/graphics/d3d12/structs/d3d12_tex2dms_array_dsv_public) 結構，指定多重取樣 2D 紋理的陣列。

## 備註

以下是深度樣板檢視的有效格式：

<ul>
  <li>DXGI\_FORMAT\_D16\_UNORM</li>
  <li>DXGI\_FORMAT\_D24\_UNORM\_S8\_UINT</li>
  <li>DXGI\_FORMAT\_D32\_FLOAT</li>
  <li>DXGI\_FORMAT\_D32\_FLOAT\_S8X24\_UINT</li>
  <li>DXGI\_FORMAT\_UNKNOWN</li>
</ul>

深度樣板檢視不能使用無類型格式。如果選擇的格式為 DXGI\_FORMAT\_UNKNOWN，則會使用父資源的格式。

將深度樣板檢視描述傳遞至 [ID3D12Device::CreateDepthStencilView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdepthstencilview_public) 以建立深度樣板檢視。

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機與 XBOX One 系列

## 另請參閱

[核心結構](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [CreateDepthStencilView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdepthstencilview_public.md)
- [D3D12_DSV_DIMENSION](/zh-TW/reference/graphics/d3d12/enums/d3d12_dsv_dimension_public.md)
- [D3D12_TEX2D_DSV](/zh-TW/reference/graphics/d3d12/structs/d3d12_tex2d_dsv_public.md)
- [D3D12_TEX1D_DSV](/zh-TW/reference/graphics/d3d12/structs/d3d12_tex1d_dsv_public.md)
- [D3D12_TEX2D_ARRAY_DSV](/zh-TW/reference/graphics/d3d12/structs/d3d12_tex2d_array_dsv_public.md)