Функция UpdateSubresources

Статья
06/13/2023

Обновления подресурсах необходимо заполнить все массивы подресурса, обычно путем вызова ID3D12Device::GetCopyableFootprints.

Синтаксис

UINT64 inline UpdateSubresources(
  _In_       ID3D12GraphicsCommandList          *pCmdList,
  _In_       ID3D12Resource                     *pDestinationResource,
  _In_       ID3D12Resource                     *pIntermediate,
  _In_       UINT                               FirstSubresource,
  _In_       UINT                               NumSubresources,
             UINT64                             RequiredSize,
  _In_ const D3D12_PLACED_SUBRESOURCE_FOOTPRINT *pLayouts,
  _In_ const UINT                               *pNumRows,
  _In_ const UINT64                             *pRowSizesInBytes,
  _In_ const D3D12_SUBRESOURCE_DATA             *pSrcData
);

Параметры

pCmdList [in]

Тип: ID3D12GraphicsCommandList*

Список команд в виде указателя на ID3D12GraphicsCommandList.

pDestinationResource [in]

Тип: ID3D12Resource*

Целевой ресурс в качестве указателя на ID3D12Resource.

pIntermediate [in]

Тип: ID3D12Resource*

Промежуточный ресурс в качестве указателя на ID3D12Resource.

FirstSubresource [in]

Тип: UINT

Индекс первого подресурса в ресурсе. Диапазон допустимых значений — от 0 до D3D12_REQ_SUBRESOURCES.

NumSubresources [in]

Тип: UINT

Количество вложенных ресурсов в ресурсе. Диапазон допустимых значений — от 0 до (D3D12_REQ_SUBRESOURCES — FirstSubresource).

RequiredSize

Тип: UINT64

Требуемый размер (в байтах) для обновления.

pLayouts [in]

Тип: const D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Указатель на массив (с длиной NumSubresources) указателей на структуры, содержащие описание и размещение подресурсов ресурса.

pNumRows [in]

Тип: const UINT*

Указатель на массив (длиной NumSubresources) UINTS, содержащий количество строк для каждого подресурса.

pRowSizesInBytes [in]

Тип: const UINT64*

Указатель на массив (с длиной NumSubresources) UINTS, содержащий размер каждой строки в байтах.

pSrcData [in]

Тип: const D3D12_SUBRESOURCE_DATA*

Указатель на массив (с длиной NumSubresources) указателей на D3D12_SUBRESOURCE_DATA структуры, содержащие описания данных подресурса, используемых для обновления.

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

Тип: UINT64

Размер (в байтах) буфера.

Требования

Требование	Значение
Заголовок	D3dx12.h
Библиотека	D3D12.lib
DLL	D3D12.dll

См. также раздел

Вспомогательные функции для D3D12
Подресурсы

Поделиться через