ID3D12GraphicsCommandList1::AtomicCopyBufferUINT-Methode (d3d12.h)

Atomar kopiert ein primäres Datenelement vom Typ UINT von einer Ressource in eine andere, zusammen mit optionalen abhängigen Ressourcen.

Diese "abhängigen Ressourcen" werden so benannt, da sie vom primären Datenelement abhängig sind, um sie zu finden. In der Regel ist das Schlüsselelement eine Adresse, ein Index oder ein anderes Handle, das sich indirekt auf eine oder mehrere abhängige Ressourcen bezieht.

Diese Funktion unterstützt ein primäres Datenelement vom Typ UINT (32 Bit). Eine andere Version dieser Funktion, AtomicCopyBufferUINT64, unterstützt ein primäres Datenelement vom Typ UINT64 (64 Bit).

Syntax

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

Parameter

[in] pDstBuffer

Typ: ID3D12Resource*

SAL: In

Die Ressource, in die das primäre UINT-Datenelement kopiert wird.

DstOffset

Typ: UINT64

Ein Offset in den Zielressourcenpuffer, der angibt, wo das primäre Datenelement in Bytes kopiert wird. Dieser Offset in Kombination mit der Basisadresse des Ressourcenpuffers muss zu einer Speicheradresse führen, die natürlich für UINT-Werte ausgerichtet ist.

[in] pSrcBuffer

Typ: ID3D12Resource*

SAL: In

Die Ressource, aus der das primäre UINT-Datenelement kopiert wird. Bei diesen Daten handelt es sich in der Regel um eine Adresse, einen Index oder ein anderes Handle, das Shadercode verwenden kann, um die neueste Version von vertraulichen Latenzinformationen zu suchen.

SrcOffset

Typ: UINT64

Ein Offset in den Quellressourcenpuffer, der angibt, wo das primäre Datenelement in Bytes kopiert wird. Dieser Offset in Kombination mit der Basisadresse des Ressourcenpuffers muss zu einer Speicheradresse führen, die natürlich für UINT-Werte ausgerichtet ist.

Dependencies

Typ: UINT

Die Anzahl der abhängigen Ressourcen.

[in] ppDependentResources

Typ: ID3D12Resource*

SAL: In_reads(Dependencies)

Ein Array von Ressourcen, die die abhängigen Elemente der Datennutzlast enthalten.

[in] pDependentSubresourceRanges

Typ: const D3D12_SUBRESOURCE_RANGE_UINT64*

SAL: In_reads(Dependencies)

Ein Array von Unterressourcenbereichen, die die abhängigen Elemente der Datennutzlast angeben. Diese Elemente werden vollständig aktualisiert, bevor das primäre Datenelement selbst atomar kopiert wird. Dadurch wird sichergestellt, dass der gesamte Vorgang logisch atomar ist; Das heißt, das primäre Datenelement bezieht sich nie auf eine unvollständige Datennutzlast.

Rückgabewert

Keine

Bemerkungen

Diese Methode wird in der Regel verwendet, um Ressourcen zu aktualisieren, bei denen die normale Renderingpipelinelatenz sich negativ auf die Benutzerfreundlichkeit auswirken kann. Beispielsweise kann eine Anwendung eine Ansichtsmatrix aus der neuesten Benutzereingabe berechnen (z. B. von den Sensoren eines head-mounted Displays) und diese Funktion verwenden, um diese Matrix in Befehlslisten zu aktualisieren und zu aktivieren, die bereits an die GPU verteilt wurden, um die wahrgenommene Latenz zwischen Eingabe und Rendering zu verringern.

Anforderungen

Weitere Informationen

ID3D12GraphicsCommandList1