UpdateSubresources 函数

汇报子资源，应填充所有子资源数组，通常通过调用 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
);

parameters

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 的帮助程序函数

子资源