Syntaxe
Paramètres
pTiledResource [in]Type : ID3D12Resource * Spécifie une ressource ID3D12Resource en mosaïque sur laquelle obtenir des informations. pNumTilesForEntireResource [out, optional]
Type : UINT * Pointeur vers une variable qui reçoit le nombre de vignettes nécessaires pour stocker la ressource en mosaïque entière. pPackedMipDesc [out, optional]
Type : D3D12_PACKED_MIP_INFO * Pointeur vers une structure D3D12_PACKED_MIP_INFO que GetResourceTiling remplit avec des informations sur la façon dont les mipmaps de la ressource en mosaïque sont compactés. pStandardTileShapeForNonPackedMips [out, optional]
Type : D3D12_TILE_SHAPE * Spécifie une structure D3D12_TILE_SHAPE que GetResourceTiling remplit avec des informations sur la forme des vignettes. Il s’agit d’informations sur la façon dont les pixels s’insèrent dans les vignettes, indépendamment des dimensions de la ressource en mosaïque, sans inclure les mipmaps compactés. Si la ressource en mosaïque entière est compactée, ce paramètre n’a aucune signification, car la ressource en mosaïque n’a pas de disposition définie pour les mipmaps compactés. Dans cette situation, GetResourceTiling définit les membres de D3D12_TILE_SHAPE à zéro. pNumSubresourceTilings [in, out, optional]
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 pour lesquelles interroger les découpages en vignettes; en sortie, il s’agit du nombre réellement récupéré dans pSubresourceTilingsForNonPackedMips (limité à ce qui est disponible). FirstSubresourceTilingToGet [in]
Type : UINT Numéro de la première vignette de sous-ressource à obtenir. GetResourceTiling ignore ce paramètre si le nombre vers lequel pointe pNumSubresourceTilings est 0. pSubresourceTilingsForNonPackedMips [out]
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 compactés, GetResourceTiling définit les membres de D3D12_SUBRESOURCE_TILING à zéro, à l’exception du membre StartTileIndexInOverallResource, que GetResourceTiling définit à D3D12_PACKED_TILE (0xffffffff). La constante D3D12_PACKED_TILE indique que la structure D3D12_SUBRESOURCE_TILING entière n’a aucune signification dans cette situation, et que les informations vers lesquelles pointe le paramètre pPackedMipDesc s’appliquent.
Valeur de retour
Type : void Aucune.Remarques
Pour estimer la taille totale des ressources de texture nécessaires lors du calcul de la taille des tas et de l’appel à CreatePlacedResource, utilisez GetResourceAllocationInfo au lieu de GetResourceTiling. GetResourceTiling ne peut pas être utilisé à cette fin. Pour plus d’informations sur les ressources en mosaïque, consultez Ressources en mosaïque de volume.Configuration requise
En-tête : d3d12_xs.h ou d3d12_x.hBibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One