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

> Décrit l'état de profondeur-gabarit. (D3D12_DEPTH_STENCIL_DESC)

Décrit l'état de profondeur-gabarit.

## Syntaxe

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

### Membres

*DepthEnable*\
Type : BOOL

Spécifie s'il faut activer le test de profondeur. Définissez ce membre à **TRUE** pour activer le test de profondeur.

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

Valeur de type [D3D12\_DEPTH\_WRITE\_MASK](/fr-CA/reference/graphics/d3d12/enums/d3d12_depth_write_mask_public) qui identifie une partie du tampon de profondeur-gabarit pouvant être modifiée par les données de profondeur.

*DepthFunc*\
Type : D3D12\_COMPARISON\_FUNC

Valeur de type [D3D12\_COMPARISON\_FUNC](/fr-CA/reference/graphics/d3d12/enums/d3d12_comparison_func_public) qui identifie une fonction qui compare les données de profondeur aux données de profondeur existantes.

*StencilEnable*\
Type : BOOL

Spécifie s'il faut activer le test de gabarit. Définissez ce membre à **TRUE** pour activer le test de gabarit.

*StencilReadMask*\
Type : UINT8

Identifie une partie du tampon de profondeur-gabarit pour la lecture des données de gabarit.

*StencilWriteMask*\
Type : UINT8

Identifie une partie du tampon de profondeur-gabarit pour l'écriture des données de gabarit.

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

Structure [D3D12\_DEPTH\_STENCILOP\_DESC](/fr-CA/reference/graphics/d3d12/structs/d3d12_depth_stencilop_desc_public) qui décrit comment utiliser les résultats du test de profondeur et du test de gabarit pour les pixels dont la normale de surface est orientée vers la caméra.

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

Structure [D3D12\_DEPTH\_STENCILOP\_DESC](/fr-CA/reference/graphics/d3d12/structs/d3d12_depth_stencilop_desc_public) qui décrit comment utiliser les résultats du test de profondeur et du test de gabarit pour les pixels dont la normale de surface est orientée dans la direction opposée à la caméra.

## Remarques

Un objet [D3D12\_GRAPHICS\_PIPELINE\_STATE\_DESC](/fr-CA/reference/graphics/d3d12_x/structs/d3d12_graphics_pipeline_state_desc) contient une structure d'état de profondeur-gabarit qui contrôle la façon dont le test de profondeur-gabarit est effectué par l'étape de fusion de sortie.

Ce tableau présente les valeurs par défaut des états de profondeur-gabarit.

<table>
  <tr>
    <th>État</th>
    <th>Valeur par défaut</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

      et

      BackFace.StencilFailOp
    </td>

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

  <tr>
    <td>
      FrontFace.StencilDepthFailOp

      et

      BackFace.StencilDepthFailOp
    </td>

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

  <tr>
    <td>
      FrontFace.StencilPassOp

      et

      BackFace.StencilPassOp
    </td>

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

  <tr>
    <td>
      FrontFace.StencilFunc

      et

      BackFace.StencilFunc
    </td>

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

Les formats qui prennent en charge le gabarit sont DXGI\_FORMAT\_D24\_UNORM\_S8\_UINT et DXGI\_FORMAT\_D32\_FLOAT\_S8X24\_UINT.

## Configuration requise

**En-tête :** d3d12\_xs.h ou d3d12\_x.h\
**Bibliothèque :** d3d12\_xs.lib ou d3d12\_x.lib\
**Plateformes prises en charge :** consoles XBOX Series et famille XBOX One

## Voir aussi

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

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


## Related topics

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