Image ::GetEncoderParameterList, méthode (gdiplusheaders.h)

  • Article

La méthode Image ::GetEncoderParameterList obtient une liste des paramètres pris en charge par un encodeur d’image spécifié.

Syntaxe

Status GetEncoderParameterList(
  [in]  const CLSID       *clsidEncoder,
  [in]  UINT              size,
  [out] EncoderParameters *buffer
);

Paramètres

[in] clsidEncoder

Type : const CLSID*

Pointeur vers un CLSID qui spécifie l’encodeur.

[in] size

Type : UINT

Entier qui spécifie la taille, en octets, du tableau de mémoires tampons . Appelez la méthode Image ::GetEncoderParameterListSize pour obtenir la taille requise.

[out] buffer

Type : EncoderParameters*

Pointeur vers un objet EncoderParameters qui reçoit la liste des paramètres pris en charge.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

La méthode Image ::GetEncoderParameterList retourne un tableau d’objets EncoderParameter . Avant d’appeler Image ::GetEncoderParameterList, vous devez allouer une mémoire tampon suffisamment grande pour recevoir ce tableau, qui fait partie d’un objet EncoderParameters . Vous pouvez appeler la méthode Image ::GetEncoderParameterListSize pour obtenir la taille, en octets, de l’objet EncoderParameters requis.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

GetImageEncoders

GetImageEncodersSize

Image

Image ::GetEncoderParameterListSize

Utilisation d’encodeurs et de décodeurs d’image