共用方式為


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

子資源