Fonction UpdateSubresources

Article
06/13/2023

Mises à jour sous-ressources, tous les tableaux de sous-ressources doivent être renseignés, généralement en appelant ID3D12Device::GetCopyableFootprints.

Syntaxe

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

Paramètres

pCmdList [in]

Type : ID3D12GraphicsCommandList*

Liste de commandes, en tant que pointeur vers un ID3D12GraphicsCommandList.

pDestinationResource [in]

Type : ID3D12Resource*

Ressource de destination, en tant que pointeur vers un ID3D12Resource.

pIntermediate [in]

Type : ID3D12Resource*

Ressource intermédiaire, en tant que pointeur vers un ID3D12Resource.

FirstSubresource [in]

Type : UINT

Index de la première sous-ressource de la ressource. La plage de valeurs valides est comprise entre 0 et D3D12_REQ_SUBRESOURCES.

NumSubresources [in]

Type : UINT

Nombre de sous-ressources dans la ressource. La plage de valeurs valides est comprise entre 0 et (D3D12_REQ_SUBRESOURCES - FirstSubresource).

ObligatoireSize

Type : UINT64

Taille requise, en octets, pour la mise à jour.

pLayouts [in]

Type : const D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Pointeur vers un tableau (de longueur NumSubresources) de pointeurs vers les structures qui contiennent la description et l’emplacement des sous-ressources de la ressource.

pNumRows [in]

Type : const UINT*

Pointeur vers un tableau (de longueur NumSubresources) d’UINTS contenant le nombre de lignes pour chaque sous-ressource.

pRowSizesInBytes [in]

Type : const UINT64*

Pointeur vers un tableau (de longueur NumSubresources) d’UINTS contenant la taille, en octets, de chaque ligne.

pSrcData [in]

Type : const D3D12_SUBRESOURCE_DATA*

Pointeur vers un tableau (de longueur NumSubresources) de pointeurs vers D3D12_SUBRESOURCE_DATA structures contenant des descriptions des données de sous-ressource utilisées pour la mise à jour.

Valeur retournée

Type : UINT64

Taille en octets de la mémoire tampon.

Spécifications

Condition requise	Valeur
En-tête	D3dx12.h
Bibliothèque	D3D12.lib
DLL	D3D12.dll

Voir aussi

Fonctions d’assistance pour D3D12
Sous-ressources

Partager via