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

​
Syntaxe

​
Paramètres

ViewGPUHandleInCurrentHeap
Type : D3D12_GPU_DESCRIPTOR_HANDLE A D3D12_GPU_DESCRIPTOR_HANDLE 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. ViewCPUHandle
Type : D3D12_CPU_DESCRIPTOR_HANDLE A D3D12_CPU_DESCRIPTOR_HANDLE 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.
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.
pResource
Type : ID3D12Resource * Pointeur vers l’interface ID3D12Resource 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. Un échec de validation fait en sorte que l’appel à ID3D12GraphicsCommandList::Close 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.

​
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
Last modified on October 6, 2026