ID3D12Device8 ::GetCopyableFootprints1, méthode (d3d12.h)

Article
02/26/2024

Obtient une disposition de ressource qui peut être copiée. Aide votre application à remplir les D3D12_PLACED_SUBRESOURCE_FOOTPRINT et les D3D12_SUBRESOURCE_FOOTPRINT lors de la sous-allocation d’espace dans les tas de chargement.

Syntaxe

void GetCopyableFootprints1(
  const D3D12_RESOURCE_DESC1         *pResourceDesc,
  UINT                               FirstSubresource,
  UINT                               NumSubresources,
  UINT64                             BaseOffset,
  D3D12_PLACED_SUBRESOURCE_FOOTPRINT *pLayouts,
  UINT                               *pNumRows,
  UINT64                             *pRowSizeInBytes,
  UINT64                             *pTotalBytes
);

Paramètres

pResourceDesc

Type : const D3D12_RESOURCE_DESC1*

Description de la ressource, en tant que pointeur vers une structure D3D12_RESOURCE_DESC1 .

FirstSubresource

Type : [in] 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

Type : [in] UINT

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

BaseOffset

Type : UINT64

Décalage, en octets, de la ressource.

pLayouts

Type : [out, facultatif] D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Pointeur vers un tableau (de longueur NumSubresources) de D3D12_PLACED_SUBRESOURCE_FOOTPRINT structures, à remplir avec la description et l’emplacement de chaque sous-ressource.

pNumRows

Type : [out, facultatif] UINT*

Pointeur vers un tableau (de longueur NumSubresources) de variables entières, à remplir avec le nombre de lignes pour chaque sous-ressource.

pRowSizeInBytes

Type : [out, facultatif] UINT64*

Pointeur vers un tableau (de longueur NumSubresources) de variables entières, chaque entrée à remplir avec la taille non pavée en octets d’une ligne, de chaque sous-ressource.

Par exemple, si une ressource Texture2D a une largeur de 32 et 4 octets par pixel, pRowSizeInBytes retourne 128.

pRowSizeInBytes ne doit pas être confondu avec le pitch de ligne, car l’examen de pLayouts et l’obtention du pitch de ligne à partir de ce qui vous donnera 256 car il est aligné sur D3D12_TEXTURE_DATA_PITCH_ALIGNMENT.

pTotalBytes

Type : [out, facultatif] UINT64*

Pointeur vers une variable entière, à remplir avec la taille totale, en octets.

Valeur de retour

None

Remarques

Pour obtenir des remarques et des exemples, consultez ID3D12Device ::GetCopyableFootprints.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	d3d12.h
Bibliothèque	d3d12.lib
DLL	d3d12.dll

Partager via