ID3D12Device::GetResourceTiling, méthode (d3d12.h)

Article
08/23/2023

Obtient des informations sur la façon dont une ressource en mosaïque est divisée en vignettes.

Syntaxe

void GetResourceTiling(
  [in]                ID3D12Resource           *pTiledResource,
  [out, optional]     UINT                     *pNumTilesForEntireResource,
  [out, optional]     D3D12_PACKED_MIP_INFO    *pPackedMipDesc,
  [out, optional]     D3D12_TILE_SHAPE         *pStandardTileShapeForNonPackedMips,
  [in, out, optional] UINT                     *pNumSubresourceTilings,
  [in]                UINT                     FirstSubresourceTilingToGet,
  [out]               D3D12_SUBRESOURCE_TILING *pSubresourceTilingsForNonPackedMips
);

Paramètres

[in] pTiledResource

Type : ID3D12Resource*

Spécifie un ID3D12Resource en mosaïque sur lequel obtenir des informations.

[out, optional] pNumTilesForEntireResource

Type : UINT*

Pointeur vers une variable qui reçoit le nombre de vignettes nécessaires pour stocker l’ensemble de la ressource en mosaïque.

[out, optional] pPackedMipDesc

Type : D3D12_PACKED_MIP_INFO*

Pointeur vers une structure D3D12_PACKED_MIP_INFO que GetResourceTiling remplit d’informations sur la façon dont les mipmaps de la ressource en mosaïque sont empaquetés.

[out, optional] pStandardTileShapeForNonPackedMips

Type : D3D12_TILE_SHAPE*

Spécifie une structure D3D12_TILE_SHAPE que GetResourceTiling remplit d’informations sur la forme de vignette. Il s’agit d’informations sur la façon dont les pixels s’intègrent dans les vignettes, indépendamment des dimensions de la ressource en mosaïque, sans inclure les mipmaps packed. Si la ressource en mosaïque entière est empaquetée, ce paramètre n’a aucun sens, car la ressource en mosaïque n’a pas de disposition définie pour les mipmaps packed. Dans ce cas, GetResourceTiling définit les membres de D3D12_TILE_SHAPE sur zéros.

[in, out, optional] pNumSubresourceTilings

Type : UINT*

Pointeur vers une variable qui contient le nombre de vignettes dans la sous-ressource. En entrée, il s’agit du nombre de sous-ressources à rechercher pour les mosaïdes ; sur la sortie, il s’agit du nombre qui a été effectivement récupéré dans pSubresourceTilingsForNonPackedMips (limité à ce qui est disponible).

[in] FirstSubresourceTilingToGet

Type : UINT

Numéro de la première vignette de sous-ressource à obtenir. GetResourceTiling ignore ce paramètre si le nombre vers lequel pNumSubresourceTilings pointe est 0.

[out] pSubresourceTilingsForNonPackedMips

Type : D3D12_SUBRESOURCE_TILING*

Spécifie une structure D3D12_SUBRESOURCE_TILING que GetResourceTiling remplit avec des informations sur les vignettes de sous-ressource. Si les vignettes de sous-ressource font partie de mipmaps packed, GetResourceTiling définit les membres de D3D12_SUBRESOURCE_TILING sur zéros, à l’exception du membre StartTileIndexInOverallResource , que GetResourceTiling définit sur D3D12_PACKED_TILE (0xffffffff). La constante D3D12_PACKED_TILE indique que l’ensemble de la structure D3D12_SUBRESOURCE_TILING est vide de sens pour cette situation et que les informations que le paramètre pPackedMipDesc pointe vers s’appliquent.

Valeur de retour

None

Notes

Pour estimer la taille totale des ressources des textures nécessaires lors du calcul des tailles de tas et de l’appel de CreatePlacedResource, utilisez GetResourceAllocationInfo au lieu de GetResourceTiling. GetResourceTiling ne peut pas être utilisé pour cela.

Pour plus d’informations sur les ressources en mosaïques, consultez Ressources en mosaïques en volume.

Spécifications


Plateforme cible	Windows
En-tête	d3d12.h
Bibliothèque	D3d12.lib
DLL	D3d12.dll

Voir aussi

ID3D12Device

Sous-ressources

Share via