> ## 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](/reference/graphics/d3d12/enums/d3d12_dsv_dimension_public) 类型的值,用于指定如何访问深度模板资源。此成员还确定要在以下联合中使用哪个 \_DSV。

*Flags*\
类型:D3D12\_DSV\_FLAGS

[D3D12\_DSV\_FLAGS](/reference/graphics/d3d12/enums/d3d12_dsv_flags_public) 枚举常量的组合,使用按位或运算进行组合。
结果值指定纹理是否为只读。
传递 0 以指定它不是只读;否则,传递 **D3D12\_DSV\_FLAGS** 枚举类型的一个或多个成员。

*Texture1D*\
类型:D3D12\_TEX1D\_DSV

一个 [D3D12\_TEX1D\_DSV](/reference/graphics/d3d12/structs/d3d12_tex1d_dsv_public) 结构,用于指定 1D 纹理子资源。

*Texture1DArray*\
类型:D3D12\_TEX1D\_ARRAY\_DSV

一个 [D3D12\_TEX1D\_ARRAY\_DSV](/reference/graphics/d3d12/structs/d3d12_tex1d_array_dsv_public) 结构,用于指定 1D 纹理子资源的数组。

*Texture2D*\
类型:D3D12\_TEX2D\_DSV

一个 [D3D12\_TEX2D\_DSV](/reference/graphics/d3d12/structs/d3d12_tex2d_dsv_public) 结构,用于指定 2D 纹理子资源。

*Texture2DArray*\
类型:D3D12\_TEX2D\_ARRAY\_DSV

一个 [D3D12\_TEX2D\_ARRAY\_DSV](/reference/graphics/d3d12/structs/d3d12_tex2d_array_dsv_public) 结构,用于指定 2D 纹理子资源的数组。

*Texture2DMS*\
类型:D3D12\_TEX2DMS\_DSV

一个 [D3D12\_TEX2DMS\_DSV](/reference/graphics/d3d12/structs/d3d12_tex2dms_dsv_public) 结构,用于指定多重采样 2D 纹理。

*Texture2DMSArray*\
类型:D3D12\_TEX2DMS\_ARRAY\_DSV

一个 [D3D12\_TEX2DMS\_ARRAY\_DSV](/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](/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-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdepthstencilview_public.md)
- [D3D12_DSV_DIMENSION](/zh-CN/reference/graphics/d3d12/enums/d3d12_dsv_dimension_public.md)
- [D3D12_TEX1D_DSV](/zh-CN/reference/graphics/d3d12/structs/d3d12_tex1d_dsv_public.md)
- [D3D12_TEX2D_DSV](/zh-CN/reference/graphics/d3d12/structs/d3d12_tex2d_dsv_public.md)
- [D3D12_TEX1D_ARRAY_DSV](/zh-CN/reference/graphics/d3d12/structs/d3d12_tex1d_array_dsv_public.md)