Syntax
Parameters
pDstBuffer [in]Type: ID3D12Resource * SAL:
In
The resource that the UINT primary data element is copied into.
DstOffsetType: UINT64 An offset into the destination resource buffer that specifies where the primary data element is copied into, in bytes. This offset combined with the base address of the resource buffer must result in a memory address that’s naturally aligned for UINT values. pSrcBuffer [in]
Type: ID3D12Resource * SAL:
In
The resource that the UINT primary data element is copied from. This data is typically an address, index, or other handle that shader code can use to locate the most-recent version of latency-sensitive information.
SrcOffsetType: UINT64 An offset into the source resource buffer that specifies where the primary data element is copied from, in bytes. This offset combined with the base address of the resource buffer must result in a memory address that’s naturally aligned for UINT values. Dependencies
Type: UINT The number of dependent resources. ppDependentResources [in]
Type: ID3D12Resource *const * SAL:
In_reads(Dependencies)
An array of resources that contain the dependent elements of the data payload.
pDependentSubresourceRanges [in]Type: const D3D12_SUBRESOURCE_RANGE_UINT64 * SAL:
In_reads(Dependencies)
An array of subresource ranges that specify the dependent elements of the data payload. These elements are completely updated before the primary data element is itself atomically copied. This ensures that the entire operation is logically atomic; that is, the primary data element never refers to an incomplete data payload.
Return value
Type: void None.Remarks
This method is typically used to update resources for which normal rendering pipeline latency can be detrimental to user experience. For example, an application can compute a view matrix from the latest user input (such as from the sensors of a head-mounted display), and use this function to update and activate this matrix in command lists already dispatched to the GPU to reduce perceived latency between input and rendering.Requirements
Header: d3d12_xs.h or d3d12_x.hLibrary: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family