Passer au contenu principal
Copie de manière atomique un élément de données principal de type UINT d’une ressource vers une autre, ainsi que des ressources dépendantes facultatives. Ces « ressources dépendantes » sont ainsi nommées car elles dépendent de l’élément de données principal pour être localisées ; en général, l’élément clé est une adresse, un index ou un autre handle qui fait référence indirectement à une ou plusieurs des ressources dépendantes. Cette fonction prend en charge un élément de données principal de type UINT (32 bits). Une autre version de cette fonction, AtomicCopyBufferUINT64, prend en charge un élément de données principal de type UINT64 (64 bits).

Syntaxe

Paramètres

pDstBuffer [in]
Type : ID3D12Resource *
SAL: In Ressource dans laquelle l’élément de données principal UINT est copié. DstOffset
Type : UINT64
Décalage, en octets, dans la mémoire tampon de la ressource de destination, qui spécifie l’emplacement où l’élément de données principal est copié. Ce décalage, combiné à l’adresse de base de la mémoire tampon de la ressource, doit produire une adresse mémoire naturellement alignée pour les valeurs UINT. pSrcBuffer [in]
Type : ID3D12Resource *
SAL: In Ressource à partir de laquelle l’élément de données principal UINT est copié. Ces données sont généralement une adresse, un index ou un autre handle que le code du nuanceur peut utiliser pour localiser la version la plus récente d’informations sensibles à la latence. SrcOffset
Type : UINT64
Décalage, en octets, dans la mémoire tampon de la ressource source, qui spécifie l’emplacement à partir duquel l’élément de données principal est copié. Ce décalage, combiné à l’adresse de base de la mémoire tampon de la ressource, doit produire une adresse mémoire naturellement alignée pour les valeurs UINT. Dependencies
Type : UINT
Nombre de ressources dépendantes. ppDependentResources [in]
Type : ID3D12Resource *const *
SAL: In_reads(Dependencies) Tableau de ressources qui contiennent les éléments dépendants de la charge utile de données. pDependentSubresourceRanges [in]
Type : const D3D12_SUBRESOURCE_RANGE_UINT64 *
SAL: In_reads(Dependencies) Tableau de plages de sous-ressources qui spécifient les éléments dépendants de la charge utile de données. Ces éléments sont entièrement mis à jour avant que l’élément de données principal lui-même ne soit copié de manière atomique. Cela garantit que l’ensemble de l’opération est logiquement atomique ; autrement dit, l’élément de données principal ne fait jamais référence à une charge utile de données incomplète.

Valeur de retour

Type : void Aucune.

Notes

Cette méthode est généralement utilisée pour mettre à jour des ressources pour lesquelles la latence normale du pipeline de rendu peut nuire à l’expérience utilisateur. Par exemple, une application peut calculer une matrice de vue à partir de la dernière entrée utilisateur (provenant par exemple des capteurs d’un casque) et utiliser cette fonction pour mettre à jour et activer cette matrice dans des listes de commandes déjà envoyées au GPU, afin de réduire la latence perçue entre l’entrée et le rendu.

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

ID3D12GraphicsCommandList1
Dernière modification le 6 octobre 2026