Sintaxe
Parâmetros
RenderTargetView [in]Tipo: D3D12_CPU_DESCRIPTOR_HANDLE Especifica uma estrutura D3D12_CPU_DESCRIPTOR_HANDLE que descreve o identificador de descritor de CPU que representa o início do heap do destino de renderização a ser limpo. ColorRGBA [in]
Tipo: const FLOAT[4] Uma matriz de 4 componentes que representa a cor com a qual preencher o destino de renderização. 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, ClearRenderTargetView limpará a exibição de recurso inteira.
Valor retornado
Tipo: void Nenhum.Comentários
ClearRenderTargetView pode ser usado para inicializar recursos que usam alias para a mesma memória de heap. Consulte CreatePlacedResource para obter mais detalhes.Observações específicas do XBOX
Passar o valor -1 para o parâmetro RectCount e nullptr para o parâmetro pRects ativará uma operação de limpeza de finalidade especial para configurações específicas de destinos de renderização MSAA. Essa limpeza especial limpará apenas a superfície de metadados DCC de um destino de renderização MSAA 4x ou 8x que usa DCC, mas não máscara de fragmento (FMask). Essa limpeza especial terá o efeito de limpar apenas as amostras 0-1, deixando as amostras 2 e superiores não inicializadas.Validação de 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 a 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 ClearRenderTargetView, o estado deve ser D3D12_RESOURCE_STATE_RENDER_TARGET.Requisitos
Cabeçalho: d3d12_xs.hBiblioteca: d3d12_xs.lib
Plataformas compatíveis: consoles XBOX Series