共用方式為

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
程式庫 d3d12.lib
Dll d3d12.dll

另請參閱