Méthode IWICDdsDecoder ::GetFrame (wincodec.h)

Récupère le cadre spécifié de l’image DDS.

Syntaxe

HRESULT GetFrame(
  [in]  UINT                  arrayIndex,
  [in]  UINT                  mipLevel,
  [in]  UINT                  sliceIndex,
  [out] IWICBitmapFrameDecode **ppIBitmapFrame
);

Paramètres

[in] arrayIndex

Type : UINT

Index demandé dans le tableau de textures.

[in] mipLevel

Type : UINT

Niveau mip demandé.

[in] sliceIndex

Type : UINT

Tranche demandée dans la texture 3D.

[out] ppIBitmapFrame

Type : IWICBitmapFrameDecode**

Pointeur vers un objet IWICBitmapFrameDecode .

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Un fichier DDS peut contenir plusieurs images organisées dans une hiérarchie à trois niveaux. Tout d’abord, le fichier DDS peut contenir plusieurs textures dans un tableau de textures. Deuxièmement, chaque texture peut avoir plusieurs niveaux de mip. Enfin, la texture peut être une texture 3D (volume) et avoir plusieurs tranches, chacune d’elles étant une texture 2D. Pour plus d’informations, consultez la documentation DDS .

WIC mappe cette hiérarchie à trois niveaux dans un tableau linéaire de IWICBitmapFrameDecode, accessible via IWICBitmapDecoder ::GetFrame. Toutefois, déterminer quel frame correspond à une triade de valeur arrayIndex, mipLevel et sliceIndex n’est pas trivial, car chaque niveau mip d’une texture 3D a une profondeur différente (nombre de tranches). Cette méthode offre une commodité supplémentaire par rapport à IWICBitmapDecoder ::GetFrame pour les images DDS en calculant la trame correcte en fonction des trois index.

Configuration requise

Condition requise	Valeur
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	wincodec.h
Bibliothèque	Windowscodecs.lib
DLL	Windowscodecs.dll

Voir aussi

CreateBitmap

ID3D11Device ::CreateTexture2D

IWICDdsDecoder

WICDdsFormatInfo