> ## 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.

# ClearUnorderedAccessViewFloat

> Définit tous les éléments d'une vue d'accès non ordonné sur les valeurs float spécifiées.

Définit tous les éléments d'une vue d'accès non ordonné (UAV) sur les valeurs float spécifiées.

## Syntaxe

```cpp theme={null}
void ClearUnorderedAccessViewFloat(
    D3D12_GPU_DESCRIPTOR_HANDLE ViewGPUHandleInCurrentHeap,
    D3D12_CPU_DESCRIPTOR_HANDLE ViewCPUHandle,
    ID3D12Resource  pResource,
    const FLOAT  Values,
    UINT NumRects,
    const D3D12_RECT  pRects
)
```

### Paramètres

*ViewGPUHandleInCurrentHeap*\
Type : D3D12\_GPU\_DESCRIPTOR\_HANDLE

A [D3D12\_GPU\_DESCRIPTOR\_HANDLE](/fr-CA/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public) qui référence un descripteur initialisé pour la vue d'accès non ordonné (UAV) à effacer. Ce descripteur doit se trouver dans un tas de descripteurs visible par les nuanceurs, qui doit être défini sur la liste de commandes au moyen de [SetDescriptorHeaps](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setdescriptorheaps_public).

*ViewCPUHandle*\
Type : D3D12\_CPU\_DESCRIPTOR\_HANDLE

A [D3D12\_CPU\_DESCRIPTOR\_HANDLE](/fr-CA/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public) dans un tas de descripteurs non visible par les nuanceurs qui référence un descripteur initialisé pour la vue d'accès non ordonné (UAV) à effacer.

<Info>
  Ce descripteur ne doit pas se trouver dans un tas de descripteurs visible par les nuanceurs. Cela permet aux pilotes qui implémentent l'effacement sous forme d'opération matérielle à fonction fixe (plutôt que sous forme de dispatch) de lire efficacement le descripteur, car les tas visibles par les nuanceurs peuvent être créés dans une mémoire **WRITE\_BACK** (semblable aux types de tas **D3D12\_HEAP\_TYPE\_UPLOAD**), et les lectures du processeur à partir de ce type de mémoire sont excessivement lentes.
</Info>

*pResource*\
Type : ID3D12Resource \*

Pointeur vers l'interface [ID3D12Resource](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs) qui représente la ressource de vue d'accès non ordonné (UAV) à effacer.

*Values*\
Type : const FLOAT \*

Tableau à 4 composants contenant les valeurs avec lesquelles remplir la ressource de vue d'accès non ordonné.

*NumRects*\
Type : UINT

Nombre de rectangles dans le tableau spécifié par le paramètre *pRects*.

*pRects*\
Type : const D3D12\_RECT \*

Tableau de structures **D3D12\_RECT** pour les rectangles de la vue de ressource à effacer. Si la valeur est **NULL**, **ClearUnorderedAccessViewFloat** efface toute la vue de ressource.

### Valeur de retour

Type : void

Aucune.

## Remarques

### Validation du runtime

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

Si vous souhaitez effacer l'UAV avec un modèle de bits précis, envisagez d'utiliser [ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public).

Un échec de validation fait en sorte que l'appel à [ID3D12GraphicsCommandList::Close](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_close_public) retourne **E\_INVALIDARG**.

### Couche de débogage

La couche de débogage émet des erreurs si les valeurs d'entrée se trouvent hors d'une plage normalisée.

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 **ClearUnorderedAccessViewFloat**, l'état doit être [D3D12\_RESOURCE\_STATE\_UNORDERED\_ACCESS](/fr-CA/reference/graphics/d3d12_x/enums/d3d12_resource_states).

## Configuration requise

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

## Voir aussi

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


## Related topics

- [ClearUnorderedAccessViewFloat](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public.md)
- [D3D12_GPU_DESCRIPTOR_HANDLE](/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public.md)
- [D3D12_CPU_DESCRIPTOR_HANDLE](/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md)