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:Requisitos
Cabeçalho: d3d12_xs.h ou d3d12_x.hBiblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One
