Condividi tramite

Metodo ID3D12GraphicsCommandList1::AtomicCopyBufferUINT (d3d12.h)

  • Articolo

Atomicamente copia un elemento dati primario di tipo UINT da una risorsa a un'altra, insieme alle risorse dipendenti facoltative.

Queste "risorse dipendenti" sono denominate in modo denominato perché dipendono dall'elemento dati primario per individuarle, in genere l'elemento chiave è un indirizzo, un indice o un altro handle che fa riferimento a una o più risorse dipendenti indirettamente.

Questa funzione supporta un elemento dati primario di tipo UINT (32bit). Una versione diversa di questa funzione, AtomicCopyBufferUINT64, supporta un elemento dati primario di tipo UINT64 (64bit).

Sintassi

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
);

Parametri

[in] pDstBuffer

Tipo: ID3D12Resource*

SAL: In

Risorsa copiata dall'elemento dati primario UINT.

DstOffset

Tipo: UINT64

Offset nel buffer delle risorse di destinazione che specifica dove l'elemento dati primario viene copiato in byte. Questo offset combinato con l'indirizzo di base del buffer di risorse deve generare un indirizzo di memoria allineato naturalmente per i valori UINT.

[in] pSrcBuffer

Tipo: ID3D12Resource*

SAL: In

Risorsa copiata dall'elemento dati primario UINT. Questi dati sono in genere un indirizzo, un indice o un altro handle che il codice shader può usare per individuare la versione più recente delle informazioni sensibili alla latenza.

SrcOffset

Tipo: UINT64

Offset nel buffer di risorse di origine che specifica la posizione in cui l'elemento dati primario viene copiato da, in byte. Questo offset combinato con l'indirizzo di base del buffer di risorse deve generare un indirizzo di memoria allineato naturalmente per i valori UINT.

Dependencies

Tipo: UINT

Numero di risorse dipendenti.

[in] ppDependentResources

Tipo: ID3D12Resource*

SAL: In_reads(Dependencies)

Matrice di risorse che contengono gli elementi dipendenti del payload dei dati.

[in] pDependentSubresourceRanges

Tipo: const D3D12_SUBRESOURCE_RANGE_UINT64*

SAL: In_reads(Dependencies)

Matrice di intervalli di sottorisorse che specificano gli elementi dipendenti del payload dei dati. Questi elementi vengono completamente aggiornati prima che l'elemento dati primario venga copiato atomicamente. Ciò garantisce che l'intera operazione sia logicamente atomica; ovvero, l'elemento dati primario non fa mai riferimento a un payload di dati incompleto.

Valore restituito

nessuno

Osservazioni

Questo metodo viene in genere usato per aggiornare le risorse per cui la latenza normale della pipeline di rendering può essere dannosa per l'esperienza utente. Ad esempio, un'applicazione può calcolare una matrice di visualizzazione dall'input utente più recente (ad esempio dai sensori di uno schermo montato sulla testa) e usare questa funzione per aggiornare e attivare questa matrice negli elenchi di comandi già inviati alla GPU per ridurre la latenza percepita tra input e rendering.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione d3d12.h
Libreria D3d12.lib
DLL D3d12.dll

Vedi anche

ID3D12GraphicsCommandList1