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
);

參數

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 的協助程式函式

子資源