> ## 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) : définit tous les éléments d'une cible de rendu sur une même valeur.

## Syntaxe

```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
)
```

Définit tous les éléments d'une cible de rendu sur une même valeur.

### Paramètres

*RenderTargetView \[in]*\
Type : **D3D12\_CPU\_DESCRIPTOR\_HANDLE**

Spécifie une structure D3D12\_CPU\_DESCRIPTOR\_HANDLE qui décrit le handle de descripteur CPU représentant le début du tas pour la cible de rendu à effacer.

*ColorRGBA \[in]*\
Type : **const FLOAT\[4]**

Tableau à 4 composantes qui représente la couleur avec laquelle remplir la cible de rendu.

*NumRects \[in]*\
Type : **UINT**

Nombre de rectangles dans le tableau spécifié par le paramètre <i>pRects</i>.

*pRects \[in]*\
Type : **const D3D12\_RECT**\*

Tableau de structures **D3D12\_RECT** correspondant aux rectangles de la vue de ressource à effacer. Si la valeur est **NULL**, **ClearRenderTargetView** efface la totalité de la vue de ressource.

### Valeur de retour

Type : void

Aucune.

## Remarques

**ClearRenderTargetView** peut être utilisé pour initialiser des ressources qui partagent par alias la même mémoire de tas. Pour plus d'informations, consultez CreatePlacedResource.

### Notes propres à XBOX

Le fait de transmettre la valeur -1 pour le paramètre RectCount et nullptr pour le paramètre pRects active une opération d'effacement spéciale destinée à des configurations spécifiques de cibles de rendu MSAA.
Cet effacement spécial efface uniquement la surface de métadonnées DCC d'une cible de rendu MSAA 4x ou 8x qui utilise DCC mais pas le masque de fragment (FMask).
Cet effacement spécial a pour effet de n'effacer que les échantillons 0-1, en laissant les échantillons 2 et supérieurs non initialisés.

### Validation du runtime

Pour les entrées à virgule flottante, le runtime définit les valeurs dénormalisées sur 0 (tout en conservant les NAN).

Un échec de validation entraîne le retour de **E\_INVALIDARG** par l'appel à Close.

### Couche de débogage

La couche de débogage émet des erreurs si les couleurs d'entrée sont dénormalisées.

La couche de débogage émet une erreur si les sous-ressources référencées par la vue ne sont pas dans l'état approprié.
Pour **ClearRenderTargetView**, l'état doit être D3D12\_RESOURCE\_STATE\_RENDER\_TARGET.

## Configuration requise

**En-tête :** d3d12\_xs.h\
**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge :** consoles XBOX Series





## Voir aussi

[ID3D12GraphicsCommandList](/fr/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

- [D3D12_CPU_DESCRIPTOR_HANDLE](/fr/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md)
- [ClearUnorderedAccessViewFloat](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public.md)
- [ClearUnorderedAccessViewUint](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public.md)
- [D3D12_GPU_DESCRIPTOR_HANDLE](/fr/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public.md)
- [D3D12_CLEAR_FLAGS](/fr/reference/graphics/d3d12/enums/d3d12_clear_flags_public.md)