ID3D12GraphicsCommandList1::AtomicCopyBufferUINT, méthode (d3d12.h)
Copie atomiquement un élément de données principal de type UINT d’une ressource à 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 les localiser. 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 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
void AtomicCopyBufferUINT(
[in] ID3D12Resource *pDstBuffer,
UINT64 DstOffset,
[in] ID3D12Resource *pSrcBuffer,
UINT64 SrcOffset,
UINT Dependencies,
[in] ID3D12Resource * const *ppDependentResources,
[in] const D3D12_SUBRESOURCE_RANGE_UINT64 *pDependentSubresourceRanges
);
Paramètres
[in] pDstBuffer
Type : ID3D12Resource*
SAL : In
Ressource dans laquelle l’élément de données principal UINT est copié.
DstOffset
Type : UINT64
Décalage dans la mémoire tampon de ressources de destination qui spécifie l’emplacement dans lequel l’élément de données principal est copié, en octets. Ce décalage combiné à l’adresse de base de la mémoire tampon de ressource doit entraîner une adresse mémoire naturellement alignée pour les valeurs UINT.
[in] pSrcBuffer
Type : ID3D12Resource*
SAL : In
Ressource à partir de laquelle l’élément de données primaire 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 des informations sensibles à la latence.
SrcOffset
Type : UINT64
Décalage 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é, en octets. Ce décalage combiné à l’adresse de base de la mémoire tampon de ressource doit entraîner une adresse mémoire naturellement alignée pour les valeurs UINT.
Dependencies
Type : UINT
Nombre de ressources dépendantes.
[in] ppDependentResources
Type : ID3D12Resource*
SAL : In_reads(Dependencies)
Tableau de ressources qui contiennent les éléments dépendants de la charge utile de données.
[in] pDependentSubresourceRanges
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 complètement mis à jour avant que l’élément de données principal ne soit lui-même 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
None
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 d’affichage à partir de la dernière entrée utilisateur (par exemple, à partir des capteurs d’un écran monté en tête), et utiliser cette fonction pour mettre à jour et activer cette matrice dans les listes de commandes déjà envoyées au GPU afin de réduire la latence perçue entre l’entrée et le rendu.
Spécifications
| Plateforme cible | Windows |
| En-tête | d3d12.h |
| Bibliothèque | D3d12.lib |
| DLL | D3d12.dll |