> ## 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

> Descreve os sub-recursos de uma textura que são acessíveis a partir de uma exibição de profundidade-estêncil.

Descreve os sub-recursos de uma textura que são acessíveis a partir de uma exibição de profundidade-estêncil.

## Sintaxe

```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
```

### Membros

*Format*\
Tipo: DXGI\_FORMAT

Um valor do tipo [DXGI\_FORMAT](https://learn.microsoft.com/en-us/windows/desktop/api/dxgiformat/ne-dxgiformat-dxgi_format) que especifica o formato de exibição. Para os formatos permitidos, consulte Comentários.

*ViewDimension*\
Tipo: D3D12\_DSV\_DIMENSION

Um valor do tipo [D3D12\_DSV\_DIMENSION](/pt-BR/reference/graphics/d3d12/enums/d3d12_dsv_dimension_public) que especifica como o recurso de profundidade-estêncil será acessado. Esse membro também determina qual \_DSV usar na união a seguir.

*Flags*\
Tipo: D3D12\_DSV\_FLAGS

Uma combinação de constantes da enumeração [D3D12\_DSV\_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_dsv_flags_public) combinadas usando uma operação OR bit a bit.
O valor resultante especifica se a textura é somente leitura.
Passe 0 para especificar que ela não é somente leitura; caso contrário, passe um ou mais dos membros do tipo enumerado **D3D12\_DSV\_FLAGS**.

*Texture1D*\
Tipo: D3D12\_TEX1D\_DSV

Uma estrutura [D3D12\_TEX1D\_DSV](/pt-BR/reference/graphics/d3d12/structs/d3d12_tex1d_dsv_public) que especifica um sub-recurso de textura 1D.

*Texture1DArray*\
Tipo: D3D12\_TEX1D\_ARRAY\_DSV

Uma estrutura [D3D12\_TEX1D\_ARRAY\_DSV](/pt-BR/reference/graphics/d3d12/structs/d3d12_tex1d_array_dsv_public) que especifica uma matriz de sub-recursos de textura 1D.

*Texture2D*\
Tipo: D3D12\_TEX2D\_DSV

Uma estrutura [D3D12\_TEX2D\_DSV](/pt-BR/reference/graphics/d3d12/structs/d3d12_tex2d_dsv_public) que especifica um sub-recurso de textura 2D.

*Texture2DArray*\
Tipo: D3D12\_TEX2D\_ARRAY\_DSV

Uma estrutura [D3D12\_TEX2D\_ARRAY\_DSV](/pt-BR/reference/graphics/d3d12/structs/d3d12_tex2d_array_dsv_public) que especifica uma matriz de sub-recursos de textura 2D.

*Texture2DMS*\
Tipo: D3D12\_TEX2DMS\_DSV

Uma estrutura [D3D12\_TEX2DMS\_DSV](/pt-BR/reference/graphics/d3d12/structs/d3d12_tex2dms_dsv_public) que especifica uma textura 2D multiamostrada.

*Texture2DMSArray*\
Tipo: D3D12\_TEX2DMS\_ARRAY\_DSV

Uma estrutura [D3D12\_TEX2DMS\_ARRAY\_DSV](/pt-BR/reference/graphics/d3d12/structs/d3d12_tex2dms_array_dsv_public) que especifica uma matriz de texturas 2D multiamostradas.

## Comentários

Estes são os formatos válidos para uma exibição de profundidade-estêncil:

<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>

Uma exibição de profundidade-estêncil não pode usar um formato sem tipo. Se o formato escolhido for DXGI\_FORMAT\_UNKNOWN, o formato do recurso pai será usado.

Passe uma descrição de exibição de profundidade-estêncil para [ID3D12Device::CreateDepthStencilView](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdepthstencilview_public) para criar uma exibição de profundidade-estêncil.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[Estruturas principais](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

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