ID3D12GraphicsCommandList ::ClearUnorderedAccessViewUint, méthode (d3d12.h)

  • Article

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

Syntaxe

void ClearUnorderedAccessViewUint(
  D3D12_GPU_DESCRIPTOR_HANDLE ViewGPUHandleInCurrentHeap,
  D3D12_CPU_DESCRIPTOR_HANDLE ViewCPUHandle,
  ID3D12Resource              *pResource,
  const UINT [4]              Values,
  UINT                        NumRects,
  const D3D12_RECT            *pRects
);

Paramètres

ViewGPUHandleInCurrentHeap

Type : [in] D3D12_GPU_DESCRIPTOR_HANDLE

D3D12_GPU_DESCRIPTOR_HANDLE qui fait référence à un descripteur initialisé pour la vue d’accès non ordonné (UAV) qui doit être effacée. Ce descripteur doit se trouver dans un tas de descripteur visible par le nuanceur, qui doit être défini dans la liste des commandes via SetDescriptorHeaps.

ViewCPUHandle

Type : [in] D3D12_CPU_DESCRIPTOR_HANDLE

Un D3D12_CPU_DESCRIPTOR_HANDLE dans un tas de descripteur visible non-nuanceur qui fait référence à un descripteur initialisé pour la vue d’accès non ordonné (UAV) qui doit être effacée.

Important

Ce descripteur ne doit pas se trouver dans un tas de descripteur visible par le nuanceur. Il s’agit de permettre aux pilotes qui implémentent le clear en tant qu’opération matérielle à fonction fixe (plutôt qu’en tant que répartiteur) de lire efficacement à partir du descripteur, car les tas visibles par le nuanceur peuvent être créés dans WRITE_BACK mémoire (comme D3D12_HEAP_TYPE_UPLOAD types de tas) et les lectures du processeur à partir de ce type de mémoire sont excessivement lentes.

pResource

Type : [in] ID3D12Resource*

Pointeur vers l’interface ID3D12Resource qui représente la ressource unordered-access-view (UAV) à effacer.

Values

Type : [in] const UINT[4]

Tableau à 4 composants qui contient les valeurs à remplir pour la ressource unordered-access-view.

NumRects

Type : [in] UINT

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

pRects

Type : [in] const D3D12_RECT*

Tableau de structures D3D12_RECT pour effacer les rectangles de l’affichage des ressources. Si la valeur est NULL, ClearUnorderedAccessViewUint efface l’intégralité de l’affichage des ressources.

Valeur de retour

None

Remarques

Validation d'exécution

L’échec de validation entraîne le retour de E_INVALIDARG à ID3D12GraphicsCommandList ::Close.

Couche de débogage

La couche de débogage génère des erreurs si les valeurs d’entrée sont en dehors d’une plage normalisée.

La couche de débogage génère une erreur si les sous-ressources référencées par la vue ne sont pas dans l’état approprié. Pour ClearUnorderedAccessViewUint, l’état doit être D3D12_RESOURCE_STATE_UNORDERED_ACCESS.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d12.h
Bibliothèque D3d12.lib
DLL D3d12.dll

Voir aussi

Interface ID3D12GraphicsCommandList