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

Article
07/16/2024

Obtient des informations sur la façon dont une ressource 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 une id3D12Resource en mosaïque pour obtenir des informations.

[out, optional] pNumTilesForEntireResource

Type : UINT*

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

[out, optional] pPackedMipDesc

Type : D3D12_PACKED_MIP_INFO*

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

[out, optional] pStandardTileShapeForNonPackedMips

Type : D3D12_TILE_SHAPE*

Spécifie une structure D3D12_TILE_SHAPE qui GetResourceTiling remplit des informations sur la forme de vignette. Il s’agit d’informations sur l’ajustement des pixels dans les vignettes, indépendamment des dimensions de la ressource en mosaïque, sans inclure les mipmaps emballés. Si la ressource en mosaïque entière est empaquetée, ce paramètre n’a pas de signification, 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. Lors de l’entrée, il s’agit du nombre de sous-ressources pour laquelle interroger des mosaïques ; en sortie, il s’agit du nombre qui a été réellement récupéré à 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 pNumSubresourceTilings points à 0.

[out] pSubresourceTilingsForNonPackedMips

Type : D3D12_SUBRESOURCE_TILING*

Spécifie une structure D3D12_SUBRESOURCE_TILING qui GetResourceTiling remplit des informations sur les vignettes de sous-source. Si les vignettes de sous-source font partie de mipmaps empaquetées, GetResourceTiling définit les membres de D3D12_SUBRESOURCE_TILING sur zéros, à l’exception du membre StartTileIndexInOverallResource, qui GetResourceTiling définit sur D3D12_PACKED_TILE (0xffffffff). La constante D3D12_PACKED_TILE indique que l’ensemble de la structure D3D12_SUBRESOURCE_TILING est sans signification pour cette situation, et les informations que les points de paramètre pPackedMipDesc s’appliquent.

Valeur de retour

Aucun

Remarques

Pour estimer la taille totale des ressources requises lors du calcul des tailles de tas et de l’appel 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, reportez-vous à ressources en mosaïques en volume.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	d3d12.h
bibliothèque	D3d12.lib
DLL	D3d12.dll

Voir aussi

ID3D12Device

sous-ressources

Partager via