ID3D12CommandQueue::CopyTileMappings method

Copies mappings from a source reserved resource to a destination reserved resource.

Syntax

void CopyTileMappings(
  ID3D12Resource                        *pDstResource,
  const D3D12_TILED_RESOURCE_COORDINATE *pDstRegionStartCoordinate,
  ID3D12Resource                        *pSrcResource,
  const D3D12_TILED_RESOURCE_COORDINATE *pSrcRegionStartCoordinate,
  const D3D12_TILE_REGION_SIZE          *pRegionSize,
  D3D12_TILE_MAPPING_FLAGS              Flags
);

Parameters

pDstResource

A pointer to the destination reserved resource.

pDstRegionStartCoordinate

A pointer to a D3D12_TILED_RESOURCE_COORDINATE structure that describes the starting coordinates of the destination reserved resource.

pSrcResource

A pointer to the source reserved resource.

pSrcRegionStartCoordinate

A pointer to a D3D12_TILED_RESOURCE_COORDINATE structure that describes the starting coordinates of the source reserved resource.

pRegionSize

A pointer to a D3D12_TILE_REGION_SIZE structure that describes the size of the reserved region.

Flags

One member of D3D12_TILE_MAPPING_FLAGS.

Return Value

This method does not return a value. If an E_OUTOFMEMORY occurs, the device is removed.

Remarks

Use CopyTileMappings to copy the tile mappings from one reserved resource to another, either to duplicate a resource mapping, or to initialize a new mapping before modifying it using UpdateTileMappings.

CopyTileMappings helps with tasks such as shifting mappings around within and across reserved resources, for example, scrolling tiles. The source and destination regions can overlap; the result of the copy in this situation is as if the source was saved to a temporary location and from there written to the destination.

The destination and the source regions must each entirely fit in their resource or behavior is undefined and the debug layer will emit an error.

Requirements

   
Target Platform Windows
Header d3d12.h

See Also

ID3D12CommandQueue

UpdateTileMappings

Volume Tiled Resources