Skip to main content
Limpa o recurso de profundidade/estêncil.

Sintaxe

Parâmetros

DepthStencilView [in]
Tipo: D3D12_CPU_DESCRIPTOR_HANDLE
Descreve o identificador de descritor de CPU que representa o início do heap do estêncil de profundidade a ser limpo. ClearFlags [in]
Tipo: D3D12_CLEAR_FLAGS
Uma combinação de valores de D3D12_CLEAR_FLAGS combinados por meio de uma operação OR bit a bit. O valor resultante identifica o tipo de dados a serem limpos (buffer de profundidade, buffer de estêncil ou ambos). Depth [in]
Tipo: FLOAT
Um valor com o qual limpar o buffer de profundidade. Esse valor será limitado entre 0 e 1. Stencil [in]
Tipo: UINT8
Um valor com o qual limpar o buffer de estêncil. NumRects [in]
Tipo: UINT
O número de retângulos na matriz especificada pelo parâmetro pRects. pRects [in]
Tipo: const D3D12_RECT*
Uma matriz de estruturas D3D12_RECT para os retângulos na exibição de recurso a serem limpos. Se for NULL, ClearDepthStencilView limpará toda a exibição de recurso.

Valor retornado

Tipo: void Nenhum.

Comentários

Somente listas de comandos diretas e de pacote dão suporte a esta operação. ClearDepthStencilView pode ser usado para inicializar recursos que compartilham o mesmo alias de memória de heap. Consulte CreatePlacedResource para obter mais detalhes.

Validação do runtime

Para entradas de ponto flutuante, o runtime definirá valores desnormalizados como 0 (preservando os NANs).
Uma falha de validação fará com que a chamada para Close retorne E_INVALIDARG.

Camada de depuração

A camada de depuração emitirá erros se as cores de entrada estiverem desnormalizadas.
A camada de depuração emitirá um erro se os sub-recursos referenciados pela exibição não estiverem no estado apropriado. Para ClearDepthStencilView, o estado deve ser D3D12_RESOURCE_STATE_DEPTH_WRITE.

Exemplos

O exemplo D3D12Bundles usa ID3D12GraphicsCommandList::ClearDepthStencilView da seguinte maneira:
O exemplo D3D12Multithreading usa ID3D12GraphicsCommandList::ClearDepthStencilView da seguinte maneira:
Consulte o Código de exemplo na referência do Direct3D 12.

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

ID3D12GraphicsCommandList
Last modified on October 6, 2026