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

# D3D12XBOX_DEPTH_STENCIL_OPTIONS_DESC (família XBOX One)

> Descreve as configurações de profundidade e estêncil no estado do pipeline de gráficos.

Descreve as configurações de profundidade e estêncil no estado do pipeline de gráficos.

## Sintaxe

```cpp theme={null}
typedef struct D3D12XBOX_DEPTH_STENCIL_OPTIONS_DESC {  
    BOOL BackFaceDisable;  
    BOOL DepthBoundsDisable;  
    BOOL ColorWritesOnDepthFailEnable;  
    BOOL ColorWritesOnDepthPassDisable;  
    UINT8 StencilReadMaskBack;  
    UINT8 StencilWriteMaskBack;  
    UINT8 StencilTestRefValueFront;  
    UINT8 StencilTestRefValueBack;  
    UINT8 StencilOpRefValueFront;  
    UINT8 StencilOpRefValueBack;  
} D3D12XBOX_DEPTH_STENCIL_OPTIONS_DESC  
```

### Membros

*BackFaceDisable*\
Tipo: BOOL

Defina como *true* para desabilitar o uso dos resultados do teste de profundidade e do teste de estêncil para pixels cuja normal de superfície está voltada para longe da câmera; caso contrário, *false*.

*DepthBoundsDisable*\
Tipo: BOOL

Defina como *true* para desabilitar os limites de profundidade; caso contrário, *false*.

*ColorWritesOnDepthFailEnable*\
Tipo: BOOL

Defina como *true* para habilitar gravações de cor quando houver uma falha na detecção de profundidade; caso contrário, *false*.

*ColorWritesOnDepthPassDisable*\
Tipo: BOOL

Defina como *true* para desabilitar gravações de cor em uma aprovação de profundidade; caso contrário, *false*.

*StencilReadMaskBack*\
Tipo: UINT8

Habilita uma máscara de leitura de estêncil para pixels cuja normal de superfície está voltada para longe da câmera.

*StencilWriteMaskBack*\
Tipo: UINT8

Habilita uma máscara de gravação de estêncil para pixels cuja normal de superfície está voltada para longe da câmera.

*StencilTestRefValueFront*\
Tipo: UINT8

Habilita um valor de referência do teste de estêncil para pixels cuja normal de superfície está voltada para a câmera.

*StencilTestRefValueBack*\
Tipo: UINT8

Habilita um valor de referência do teste de estêncil para pixels cuja normal de superfície está voltada para longe da câmera.

*StencilOpRefValueFront*\
Tipo: UINT8

Habilita um valor de referência da operação de estêncil para pixels cuja normal de superfície está voltada para a câmera.

*StencilOpRefValueBack*\
Tipo: UINT8

Habilita um valor de referência da operação de estêncil para pixels cuja normal de superfície está voltada para longe da câmera.

## Comentários

As estruturas [D3D12XBOX\_DERIVED\_GRAPHICS\_STATE\_DESC](/pt-BR/reference/graphics/d3d12_x/structs/d3d12xbox_derived_graphics_state_desc) e [D3D12XBOX\_EXTENDED\_GRAPHICS\_PIPELINE\_STATE\_DESC](/pt-BR/reference/graphics/d3d12_x/structs/d3d12xbox_extended_graphics_pipeline_state_desc) usam essa estrutura.

Os formatos que oferecem suporte a estêncil são **DXGI\_FORMAT\_D24\_UNORM\_S8\_UINT** e **DXGI\_FORMAT\_D32\_FLOAT\_S8X24\_UINT**.

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Plataformas com suporte:** família XBOX One

## Confira também

[d3d12\_x](/pt-BR/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [D3D12_DEPTH_STENCIL_DESC](/es/reference/graphics/d3d12/structs/d3d12_depth_stencil_desc_public.md)
- [D3D12_DEPTH_STENCIL_VIEW_DESC](/es/reference/graphics/d3d12/structs/d3d12_depth_stencil_view_desc_public.md)
- [D3D12_DEPTH_STENCILOP_DESC](/es/reference/graphics/d3d12/structs/d3d12_depth_stencilop_desc_public.md)
- [D3D12_RENDER_PASS_DEPTH_STENCIL_DESC](/es/reference/graphics/d3d12/structs/d3d12_render_pass_depth_stencil_desc_public.md)