Метод ID3D12Device8::GetCopyableFootprints1 (d3d12.h)

Статья
02/26/2024

Возвращает макет ресурса, который можно скопировать. Помогает приложению заполнять 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*

Указатель на целочисленную переменную, заполняемую общим размером в байтах.

Возвращаемое значение

None

Remarks

Примечания и примеры см. в разделе ID3D12Device::GetCopyableFootprints.

Требования

Требование	Значение
Минимальная версия клиента	сборка Windows 10 20348
Минимальная версия сервера	сборка Windows 10 20348
Верхняя часть	d3d12.h
Библиотека	d3d12.lib
DLL	d3d12.dll

Share via