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

Recupera una lista delimitada por comas de las extensiones de nombre de archivo asociadas al códec.

Sintaxis

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

Parámetros

[in] cchFileExtensions

Tipo: UINT

Tamaño del búfer de extensión de nombre de archivo. Use 0 en la primera llamada para determinar el tamaño de búfer necesario.

[in, out] wzFileExtensions

Tipo: WCHAR*

Recibe una lista delimitada por comas de extensiones de nombre de archivo asociadas al códec. Use NULL en la primera llamada para determinar el tamaño de búfer necesario.

[in, out] pcchActual

Tipo: UINT*

Tamaño real del búfer necesario para recuperar todas las extensiones de nombre de archivo asociadas al códec.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La extensión predeterminada para un codificador de imágenes es el primer elemento de la lista de extensiones devueltas.

El patrón de uso de este método es un proceso de dos llamadas. La primera llamada recupera el tamaño del búfer necesario para recuperar el número de versión de administración de colores completo llamando a con cchFileExtensions establecido 0 en y wzFileExtensions establecido en NULL. Esta llamada establece pcchActual en el tamaño del búfer necesario. Una vez determinado el tamaño de búfer necesario, una segunda llamada a GetFileExtensions con cchFileExtensions establecida en el tamaño del búfer y wzFileExtensions establecido en un búfer del tamaño adecuado recuperará los formatos de píxel.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado wincodec.h
Library Windowscodecs.lib