> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ID3D12GraphicsCommandList::ClearRenderTargetView

> ID3D12GraphicsCommandList::ClearRenderTargetView (consoles XBOX Series): define todos os elementos de um destino de renderização como um único valor.

## Sintaxe

```cpp theme={null}
void ClearRenderTargetView(
    _In_ D3D12_CPU_DESCRIPTOR_HANDLE RenderTargetView,
    _In_ const FLOAT ColorRGBA[4],
    _In_ UINT NumRects,
    _In_reads_(NumRects) const D3D12_RECT* pRects
)
```

Define todos os elementos de um destino de renderização como um único valor.

### 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 <i>pRects</i>.

*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.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[ID3D12GraphicsCommandList](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

- [D3D12_CPU_DESCRIPTOR_HANDLE](/pt-BR/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md)
- [ClearUnorderedAccessViewFloat](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public.md)
- [ClearUnorderedAccessViewUint](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public.md)
- [D3D12_GPU_DESCRIPTOR_HANDLE](/pt-BR/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public.md)
- [D3D12_CLEAR_VALUE](/pt-BR/reference/graphics/d3d12/structs/d3d12_clear_value_public.md)