Edit

D3D12DDI_DEPTH_STENCIL_DESC structure (d3d12umddi.h)

  • Article

The D3D12DDI_DEPTH_STENCIL_DESC structure describes a depth stencil state.

Syntax

typedef struct D3D12DDI_DEPTH_STENCIL_DESC {
  BOOL                          DepthEnable;
  D3D12DDI_DEPTH_WRITE_MASK     DepthWriteMask;
  D3D12DDI_COMPARISON_FUNC      DepthFunc;
  BOOL                          StencilEnable;
  BOOL                          FrontEnable;
  BOOL                          BackEnable;
  UINT8                         StencilReadMask;
  UINT8                         StencilWriteMask;
  D3D12DDI_DEPTH_STENCILOP_DESC FrontFace;
  D3D12DDI_DEPTH_STENCILOP_DESC BackFace;
} D3D12DDI_DEPTH_STENCIL_DESC;

Members

DepthEnable

A Boolean value that specifies whether depth is enabled. TRUE indicates depth is enabled; FALSE indicates depth is disabled.

DepthWriteMask

A bitwise value that indicates the write properties for a depth stencil state. This member is a valid bitwise OR of the following values from the D3D12DDI_DEPTH_WRITE_MASK enumeration.

DepthFunc

A D3D12DDI_COMPARISON_FUNC-typed value that indicates the depth-comparison function to perform.

StencilEnable

A Boolean value that specifies whether stencil is enabled. TRUE indicates stencil is enabled; FALSE indicates stencil is disabled.

FrontEnable

A Boolean value that specifies whether the performance of stencil operations on forward-facing polygons is enabled. TRUE indicates that the performance on forward-facing polygons is enabled; FALSE indicates that it is disabled.

BackEnable

A Boolean value that specifies whether the performance of stencil operations on back-facing polygons is enabled. TRUE indicates that the performance on back-facing polygons is enabled; FALSE indicates that it is disabled.

StencilReadMask

An 8-bit bitwise value that the driver uses in a bitwise AND operation with the stencil value in the stencil buffer immediately after reading the stencil value out of the stencil buffer.

StencilWriteMask

An 8-bit bitwise value that the driver uses in a bitwise AND operation with the current stencil value before writing the result back out to the stencil buffer.

FrontFace

A D3D12DDI_DEPTH_STENCILOP_DESC structure that describes the stencil operation to perform on forward-facing polygons.

BackFace

A D3D12DDI_DEPTH_STENCILOP_DESC structure that describes the stencil operation to perform on back-facing polygons.

Remarks

If the StencilEnable member is set to TRUE, the FrontEnable member, BackEnable member, or both must also be set to TRUE.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1809
Header d3d12umddi.h