Méthode IWICFormatConverterInfo ::GetPixelFormats (wincodec.h)

Récupère une liste de GUID qui indiquent les formats de pixels pris en charge par le convertisseur.

Syntaxe

HRESULT GetPixelFormats(
  [in]      UINT               cFormats,
  [in, out] WICPixelFormatGUID *pPixelFormatGUIDs,
  [out]     UINT               *pcActual
);

Paramètres

[in] cFormats

Type : UINT

Taille du tableau pPixelFormatGUIDs .

[in, out] pPixelFormatGUIDs

Type : WICPixelFormatGUID*

Pointeur vers un tableau GUID qui reçoit les formats de pixels pris en charge par le convertisseur.

[out] pcActual

Type : UINT*

Taille réelle du tableau nécessaire pour récupérer tous les formats de pixels pris en charge par le convertisseur.

Valeur retournée

Type : HRESULT

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

Remarques

Le convertisseur de format ne garantit pas nécessairement la symétrie par rapport à la conversion ; autrement dit, un convertisseur peut être en mesure de convertir FROM un format particulier sans être réellement en mesure de convertir EN un format particulier. Pour tester la symétrie, utilisez CanConvert.

Pour déterminer le nombre de formats de pixels qu’un convertisseur peut gérer, définissez cFormats sur 0 et pPixelFormatGUIDs sur NULL. Le convertisseur remplit pcActual avec le nombre de formats pris en charge par ce convertisseur.

Configuration requise