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

> Describe el estado de galería de símbolos de profundidad. (D3D12_DEPTH_STENCIL_DESC)

Describe el estado de galería de símbolos de profundidad.

## Sintaxis

```cpp theme={null}
typedef struct D3D12_DEPTH_STENCIL_DESC
{
    BOOL DepthEnable;
    D3D12_DEPTH_WRITE_MASK DepthWriteMask;
    D3D12_COMPARISON_FUNC DepthFunc;
    BOOL StencilEnable;
    UINT8 StencilReadMask;
    UINT8 StencilWriteMask;
    D3D12_DEPTH_STENCILOP_DESC FrontFace;
    D3D12_DEPTH_STENCILOP_DESC BackFace;
} D3D12_DEPTH_STENCIL_DESC
```

### Miembros

*DepthEnable*\
Tipo: BOOL

Especifica si se habilitan las pruebas de profundidad. Establezca este miembro en **TRUE** para habilitar las pruebas de profundidad.

*DepthWriteMask*\
Tipo: D3D12\_DEPTH\_WRITE\_MASK

Un valor de tipo [D3D12\_DEPTH\_WRITE\_MASK](/reference/graphics/d3d12/enums/d3d12_depth_write_mask_public) que identifica una parte del búfer de galería de símbolos de profundidad que los datos de profundidad pueden modificar.

*DepthFunc*\
Tipo: D3D12\_COMPARISON\_FUNC

Un valor de tipo [D3D12\_COMPARISON\_FUNC](/reference/graphics/d3d12/enums/d3d12_comparison_func_public) que identifica una función que compara los datos de profundidad con los datos de profundidad existentes.

*StencilEnable*\
Tipo: BOOL

Especifica si se habilitan las pruebas de galería de símbolos. Establezca este miembro en **TRUE** para habilitar las pruebas de galería de símbolos.

*StencilReadMask*\
Tipo: UINT8

Identifica una parte del búfer de galería de símbolos de profundidad para leer los datos de galería de símbolos.

*StencilWriteMask*\
Tipo: UINT8

Identifica una parte del búfer de galería de símbolos de profundidad para escribir los datos de galería de símbolos.

*FrontFace*\
Tipo: D3D12\_DEPTH\_STENCILOP\_DESC

Una estructura [D3D12\_DEPTH\_STENCILOP\_DESC](/reference/graphics/d3d12/structs/d3d12_depth_stencilop_desc_public) que describe cómo usar los resultados de la prueba de profundidad y la prueba de galería de símbolos para los píxeles cuya normal de superficie está orientada hacia la cámara.

*BackFace*\
Tipo: D3D12\_DEPTH\_STENCILOP\_DESC

Una estructura [D3D12\_DEPTH\_STENCILOP\_DESC](/reference/graphics/d3d12/structs/d3d12_depth_stencilop_desc_public) que describe cómo usar los resultados de la prueba de profundidad y la prueba de galería de símbolos para los píxeles cuya normal de superficie está orientada en dirección opuesta a la cámara.

## Comentarios

Un objeto [D3D12\_GRAPHICS\_PIPELINE\_STATE\_DESC](/reference/graphics/d3d12_x/structs/d3d12_graphics_pipeline_state_desc) contiene una estructura de estado de galería de símbolos de profundidad que controla cómo la fase de combinación de salida realiza las pruebas de galería de símbolos de profundidad.

Esta tabla muestra los valores predeterminados de los estados de galería de símbolos de profundidad.

<table>
  <tr>
    <th>Estado</th>
    <th>Valor predeterminado</th>
  </tr>

  <tr>
    <td>DepthEnable</td>
    <td>TRUE</td>
  </tr>

  <tr>
    <td>DepthWriteMask</td>
    <td>D3D12\_DEPTH\_WRITE\_MASK\_ALL</td>
  </tr>

  <tr>
    <td>DepthFunc</td>
    <td>D3D12\_COMPARISON\_FUNC\_LESS</td>
  </tr>

  <tr>
    <td>StencilEnable</td>
    <td>FALSE</td>
  </tr>

  <tr>
    <td>StencilReadMask</td>
    <td>D3D12\_DEFAULT\_STENCIL\_READ\_MASK</td>
  </tr>

  <tr>
    <td>StencilWriteMask</td>
    <td>D3D12\_DEFAULT\_STENCIL\_WRITE\_MASK</td>
  </tr>

  <tr>
    <td>
      FrontFace.StencilFailOp

      y

      BackFace.StencilFailOp
    </td>

    <td>D3D12\_STENCIL\_OP\_KEEP</td>
  </tr>

  <tr>
    <td>
      FrontFace.StencilDepthFailOp

      y

      BackFace.StencilDepthFailOp
    </td>

    <td>D3D12\_STENCIL\_OP\_KEEP</td>
  </tr>

  <tr>
    <td>
      FrontFace.StencilPassOp

      y

      BackFace.StencilPassOp
    </td>

    <td>D3D12\_STENCIL\_OP\_KEEP</td>
  </tr>

  <tr>
    <td>
      FrontFace.StencilFunc

      y

      BackFace.StencilFunc
    </td>

    <td>D3D12\_COMPARISON\_FUNC\_ALWAYS</td>
  </tr>
</table>

Los formatos que admiten galería de símbolos son DXGI\_FORMAT\_D24\_UNORM\_S8\_UINT y DXGI\_FORMAT\_D32\_FLOAT\_S8X24\_UINT.

## Requisitos

**Encabezado:** d3d12\_xs.h o d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\
**Plataformas compatibles**: consolas XBOX Series y familia XBOX One

## Consulte también

[CD3DX12\_DEPTH\_STENCIL\_DESC](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-depth-stencil-desc)

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


## Related topics

- [D3D12_DEPTH_STENCILOP_DESC](/es/reference/graphics/d3d12/structs/d3d12_depth_stencilop_desc_public.md)
- [D3D12_DEPTH_WRITE_MASK](/es/reference/graphics/d3d12/enums/d3d12_depth_write_mask_public.md)
- [D3D12_PIPELINE_STATE_STREAM_DESC](/es/reference/graphics/d3d12/structs/d3d12_pipeline_state_stream_desc_public.md)
- [D3D12_COMPARISON_FUNC](/es/reference/graphics/d3d12/enums/d3d12_comparison_func_public.md)
- [D3D12_DEPTH_STENCIL_DESC1](/es/reference/graphics/d3d12/structs/d3d12_depth_stencil_desc1_public.md)