Pular para o conteúdo principal
Descreve o estado de profundidade/estêncil.

Sintaxe

Membros

DepthEnable
Tipo: BOOL
Especifica se o teste de profundidade deve ser habilitado. Defina esse membro como TRUE para habilitar o teste de profundidade. DepthWriteMask
Tipo: D3D12_DEPTH_WRITE_MASK
Um valor do tipo D3D12_DEPTH_WRITE_MASK que identifica uma parte do buffer de profundidade/estêncil que pode ser modificada por dados de profundidade. DepthFunc
Tipo: D3D12_COMPARISON_FUNC
Um valor do tipo D3D12_COMPARISON_FUNC que identifica uma função que compara dados de profundidade com dados de profundidade existentes. StencilEnable
Tipo: BOOL
Especifica se o teste de estêncil deve ser habilitado. Defina esse membro como TRUE para habilitar o teste de estêncil. StencilReadMask
Tipo: UINT8
Identifica uma parte do buffer de profundidade/estêncil para leitura de dados de estêncil. StencilWriteMask
Tipo: UINT8
Identifica uma parte do buffer de profundidade/estêncil para gravação de dados de estêncil. FrontFace
Tipo: D3D12_DEPTH_STENCILOP_DESC
Uma estrutura D3D12_DEPTH_STENCILOP_DESC que descreve como usar os resultados do teste de profundidade e do teste de estêncil para pixels cuja normal da superfície está voltada para a câmera. BackFace
Tipo: D3D12_DEPTH_STENCILOP_DESC
Uma estrutura D3D12_DEPTH_STENCILOP_DESC que descreve como usar os resultados do teste de profundidade e do teste de estêncil para pixels cuja normal da superfície está voltada para o lado oposto da câmera. DepthBoundsTestEnable
Tipo: BOOL
TRUE para habilitar o teste de limites de profundidade; caso contrário, FALSE. O valor padrão é FALSE.

Comentários

Um objeto D3D12_GRAPHICS_PIPELINE_STATE_DESC contém uma estrutura de estado de profundidade/estêncil que controla como o teste de profundidade/estêncil é realizado pelo estágio de fusão de saída. Esta tabela mostra os valores padrão dos estados de profundidade/estêncil.
EstadoValor padrão
DepthEnableTRUE
DepthWriteMaskD3D12_DEPTH_WRITE_MASK_ALL
DepthFuncD3D12_COMPARISON_LESS
StencilEnableFALSE
StencilReadMaskD3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMaskD3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunceBackFace.StencilFuncD3D12_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOpeBackFace.StencilDepthFailOpD3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOpeBackFace.StencilPassOpD3D12_STENCIL_OP_KEEP
FrontFace.StencilFailOpeBackFace.StencilFailOpD3D12_STENCIL_OP_KEEP
DepthBoundsTestEnableFALSE
Os formatos que dão suporte a estêncil são DXGI_FORMAT_D24_UNORM_S8_UINT e DXGI_FORMAT_D32_FLOAT_S8X24_UINT.

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
Última modificação em 6 de outubro de 2026