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
緩衝區的大小 (以位元組為單位)。
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|
DLL |
|