ID3D11Device2::GetResourceTiling, méthode (d3d11_2.h)

Article
08/22/2023

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

Syntaxe

void GetResourceTiling(
  [in]                ID3D11Resource           *pTiledResource,
  [out, optional]     UINT                     *pNumTilesForEntireResource,
  [out, optional]     D3D11_PACKED_MIP_DESC    *pPackedMipDesc,
  [out, optional]     D3D11_TILE_SHAPE         *pStandardTileShapeForNonPackedMips,
  [in, out, optional] UINT                     *pNumSubresourceTilings,
  [in]                UINT                     FirstSubresourceTilingToGet,
  [out]               D3D11_SUBRESOURCE_TILING *pSubresourceTilingsForNonPackedMips
);

Paramètres

[in] pTiledResource

Type : ID3D11Resource*

Pointeur vers la ressource en mosaïque sur laquelle obtenir des informations.

[out, optional] pNumTilesForEntireResource

Type : UINT*

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

[out, optional] pPackedMipDesc

Type : D3D11_PACKED_MIP_DESC*

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

[out, optional] pStandardTileShapeForNonPackedMips

Type : D3D11_TILE_SHAPE*

Pointeur vers une structure D3D11_TILE_SHAPE que GetResourceTiling remplit avec des informations sur la forme de la vignette. Il s’agit d’informations sur la façon dont les pixels s’ajustent dans les vignettes, indépendamment des dimensions de la ressource en mosaïque, sans inclure les mipmaps compressés. 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 D3D11_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 les mosaïques ; sur la sortie, il s’agit du nombre qui a été réellement 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 : D3D11_SUBRESOURCE_TILING*

Pointeur vers une structure de D3D11_SUBRESOURCE_TILING que GetResourceTiling remplit avec des informations sur les vignettes de sous-ressources.

Si les vignettes de sous-ressources font partie de mipmaps packed, GetResourceTiling définit les membres de D3D11_SUBRESOURCE_TILING sur zéros, à l’exception du membre StartTileIndexInOverallResource , que GetResourceTiling définit sur D3D11_PACKED_TILE (0xffffffff). La constante D3D11_PACKED_TILE indique que l’ensemble de la structure de D3D11_SUBRESOURCE_TILING n’a aucun sens pour cette situation, et que les informations sur laquelle pointe le paramètre pPackedMipDesc s’appliquent.

Valeur de retour

Aucune

Remarques

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

Configuration requise


Client minimal pris en charge	Windows 8.1 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	d3d11_2.h
Bibliothèque	D3D11.lib

Voir aussi

ID3D11Device2

Partager via