Méthode IWICBitmapCodecInfo ::GetFileExtensions (wincodec.h)

Article
08/27/2023

Récupère une liste délimitée par des virgules des extensions de nom de fichier associées au codec.

Syntaxe

HRESULT GetFileExtensions(
  [in]      UINT  cchFileExtensions,
  [in, out] WCHAR *wzFileExtensions,
  [in, out] UINT  *pcchActual
);

Paramètres

[in] cchFileExtensions

Type : UINT

Taille de la mémoire tampon d’extension de nom de fichier. Utilisez lors du 0 premier appel pour déterminer la taille de mémoire tampon nécessaire.

[in, out] wzFileExtensions

Type : WCHAR*

Reçoit une liste délimitée par des virgules des extensions de nom de fichier associées au codec. Utilisez lors du NULL premier appel pour déterminer la taille de mémoire tampon nécessaire.

[in, out] pcchActual

Type : UINT*

Taille réelle de la mémoire tampon nécessaire pour récupérer toutes les extensions de nom de fichier associées au codec.

Valeur retournée

Type : HRESULT

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

Remarques

L’extension par défaut d’un encodeur d’image est le premier élément de la liste des extensions retournées.

Le modèle d’utilisation de cette méthode est un processus d’appel à deux. Le premier appel récupère la taille de mémoire tampon nécessaire pour récupérer le numéro de version de gestion des couleurs complète en l’appelant avec cchFileExtensions défini sur 0 et wzFileExtensions défini sur NULL. Cet appel définit pcchActual sur la taille de mémoire tampon nécessaire. Une fois la taille de mémoire tampon nécessaire déterminée, un deuxième appel GetFileExtensions avec cchFileExtensions défini sur la taille de la mémoire tampon et wzFileExtensions défini sur une mémoire tampon de la taille appropriée récupère les formats de pixels.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	wincodec.h
Bibliothèque	Windowscodecs.lib

Partager via