通过

ID3D12Device8：：GetCopyableFootprints1 方法 (d3d12.h)

  • 项目

获取可复制的资源布局。 在上传堆中子分配空间时，帮助应用填充 D3D12_PLACED_SUBRESOURCE_FOOTPRINT 和 D3D12_SUBRESOURCE_FOOTPRINT 。

语法

void GetCopyableFootprints1(
  const D3D12_RESOURCE_DESC1         *pResourceDesc,
  UINT                               FirstSubresource,
  UINT                               NumSubresources,
  UINT64                             BaseOffset,
  D3D12_PLACED_SUBRESOURCE_FOOTPRINT *pLayouts,
  UINT                               *pNumRows,
  UINT64                             *pRowSizeInBytes,
  UINT64                             *pTotalBytes
);

参数

pResourceDesc

类型： const D3D12_RESOURCE_DESC1*

资源的说明，作为指向 D3D12_RESOURCE_DESC1 结构的指针。

FirstSubresource

类型：[in] UINT

资源中第一个子资源的索引。 有效值的范围是 0 到 D3D12_REQ_SUBRESOURCES。

NumSubresources

类型：[in] UINT

资源中的子资源数。 有效值范围为 0 到 (D3D12_REQ_SUBRESOURCES - FirstSubresource) 。

BaseOffset

类型： UINT64

资源偏移量（以字节为单位）。

pLayouts

类型：[out，可选] D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

指向长度为 NumSubresources 的数组 (指针，) D3D12_PLACED_SUBRESOURCE_FOOTPRINT 结构，用每个子资源的说明和位置填充。

pNumRows

类型：[out，可选] UINT*

指向长度为 NumSubresources 的数组 (指针，) 要用每个子资源的行数填充的整数变量。

pRowSizeInBytes

类型：[out，可选] UINT64*

指向长度 (为 NumSubresources 的数组的指针) 整数变量) ，每个条目将用每个子资源的未填充大小（以行的字节为单位）进行填充。

例如，如果 Texture2D 资源的宽度为 32，每个像素的字节数为 4，则 pRowSizeInBytes 返回 128。

pRowSizeInBytes 不应与 行间距混淆，因为检查 pLayouts 并从中获取行间距会获得 256，因为它与D3D12_TEXTURE_DATA_PITCH_ALIGNMENT对齐。

pTotalBytes

类型：[out，可选] UINT64*

指向要用总大小（以字节为单位）填充的整数变量的指针。

返回值

无

备注

有关备注和示例，请参阅 ID3D12Device：：GetCopyableFootprints。

要求

要求 值
最低受支持的客户端 Windows 10内部版本 20348
最低受支持的服务器 Windows 10内部版本 20348
标头 d3d12.h
Library d3d12.lib
DLL d3d12.dll

另请参阅