D3D12_TEXTURE_COPY_LOCATION structure (d3d12.h)

Describes a portion of a texture for the purpose of texture copies.

Syntax

typedef struct D3D12_TEXTURE_COPY_LOCATION {
  ID3D12Resource          *pResource;
  D3D12_TEXTURE_COPY_TYPE Type;
  union {
    D3D12_PLACED_SUBRESOURCE_FOOTPRINT PlacedFootprint;
    UINT                               SubresourceIndex;
  };
} D3D12_TEXTURE_COPY_LOCATION;

Members

pResource

Specifies the resource which will be used for the copy operation.

 

When Type is D3D12_TEXTURE_COPY_TYPE_PLACED_FOOTPRINT, pResource must point to a buffer resource.

 

When Type is D3D12_TEXTURE_COPY_TYPE_SUBRESOURCE_INDEX, pResource must point to a texture resource.

Type

Specifies which type of resource location this is: a subresource of a texture, or a description of a texture layout which can be applied to a buffer. This D3D12_TEXTURE_COPY_TYPE enum indicates which union member to use.

PlacedFootprint

Specifies a texture layout, with offset, dimensions, and pitches, for the hardware to understand how to treat a section of a buffer resource as a multi-dimensional texture. To fill-in the correct data for a CopyTextureRegion call, see D3D12_PLACED_SUBRESOURCE_FOOTPRINT.

SubresourceIndex

Specifies the index of the subresource of an arrayed, mip-mapped, or planar texture should be used for the copy operation.

Remarks

Use this structure with CopyTextureRegion.

Requirements

Requirement	Value
Header	d3d12.h

See also

CD3DX12_TEXTURE_COPY_LOCATION

Core Structures

D3D12_PLACED_SUBRESOURCE_FOOTPRINT