D3D12_PLACED_SUBRESOURCE_FOOTPRINT structure (d3d12.h)

Describes the footprint of a placed subresource, including the offset and the D3D12_SUBRESOURCE_FOOTPRINT.

Syntax

typedef struct D3D12_PLACED_SUBRESOURCE_FOOTPRINT {
  UINT64                      Offset;
  D3D12_SUBRESOURCE_FOOTPRINT Footprint;
} D3D12_PLACED_SUBRESOURCE_FOOTPRINT;

Members

Offset

The offset of the subresource within the parent resource, in bytes. The offset between the start of the parent resource and this subresource.

Footprint

The format, width, height, depth, and row-pitch of the subresource, as a D3D12_SUBRESOURCE_FOOTPRINT structure.

Remarks

This structure is used in the D3D12_TEXTURE_COPY_LOCATION structure, and by ID3D12Device::GetCopyableFootprints.

All the data referenced by the footprint structure must fit within the bounds of the parent resource. If you use GetCopyableFootprints to fill out the structure, the pTotalBytes output field indicates the required size of the resource.

This structure is also used a number of helper functions (refer to Helper Structures and Functions for D3D12).

When copying textures, use this structure along with D3D12_TEXTURE_COPY_LOCATION.

Requirements

Requirement Value
Header d3d12.h

See also

Core Structures