Funzione UpdateSubresources

Articolo
06/12/2023

Aggiornamenti sottorisorse, tutte le matrici di sottorisorse devono essere popolate, in genere chiamando ID3D12Device::GetCopyableFootprints.

Sintassi

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

Parametri

pCmdList [in]

Tipo: ID3D12GraphicsCommandList*

Elenco di comandi, come puntatore a un ID3D12GraphicsCommandList.

pDestinationResource [in]

Tipo: ID3D12Resource*

Risorsa di destinazione, come puntatore a un ID3D12Resource.

pIntermediate [in]

Tipo: ID3D12Resource*

Risorsa intermedia, come puntatore a un OGGETTO ID3D12Resource.

FirstSubresource [in]

Tipo: UINT

Indice della prima sottorisorsa nella risorsa. L'intervallo di valori validi è compreso tra 0 e D3D12_REQ_SUBRESOURCES.

NumSubresources [in]

Tipo: UINT

Numero di sottorisorse nella risorsa. L'intervallo di valori validi è compreso tra 0 e (D3D12_REQ_SUBRESOURCES - FirstSubresource).

RequiredSize

Tipo: UINT64

Dimensione richiesta, in byte, per l'aggiornamento.

pLayouts [in]

Tipo: const D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Puntatore a una matrice (di lunghezza NumSubresources) di puntatori alle strutture che contengono la descrizione e la posizione delle sottorisorse della risorsa.

pNumRows [in]

Tipo: const UINT*

Puntatore a una matrice (di lunghezza NumSubresources) di UINTS contenente il numero di righe per ogni sottorisorsa.

pRowSizesInBytes [in]

Tipo: const UINT64*

Puntatore a una matrice (di lunghezza NumSubresources) di UINTS contenente le dimensioni, in byte, di ogni riga.

pSrcData [in]

Tipo: const D3D12_SUBRESOURCE_DATA*

Puntatore a una matrice (di lunghezza NumSubresources) di puntatori a D3D12_SUBRESOURCE_DATA strutture contenenti descrizioni dei dati delle sottorisorse usate per l'aggiornamento.

Valore restituito

Tipo: UINT64

Dimensione del buffer, in byte.

Requisiti

Requisito	Valore
Intestazione	D3dx12.h
Libreria	D3D12.lib
DLL	D3D12.dll

Vedi anche

Funzioni helper per D3D12
Sottorisorse