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

子资源