Compartilhar via

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

  • Artigo

Recupera uma lista delimitada por vírgulas das extensões de nome de arquivo associadas ao codec.

Sintaxe

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

Parâmetros

[in] cchFileExtensions

Tipo: UINT

O tamanho do buffer de extensão de nome de arquivo. Use 0 na primeira chamada para determinar o tamanho necessário do buffer.

[in, out] wzFileExtensions

Tipo: WCHAR*

Recebe uma lista delimitada por vírgulas de extensões de nome de arquivo associadas ao codec. Use NULL na primeira chamada para determinar o tamanho necessário do buffer.

[in, out] pcchActual

Tipo: UINT*

O tamanho real do buffer necessário para recuperar todas as extensões de nome de arquivo associadas ao codec.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A extensão padrão para um codificador de imagem é o primeiro item na lista de extensões retornadas.

O padrão de uso para esse método é um processo de duas chamadas. A primeira chamada recupera o tamanho do buffer necessário para recuperar o número de versão de gerenciamento de cores completo chamando-o com cchFileExtensions definido 0 como e wzFileExtensions definido NULLcomo . Essa chamada define pcchActual para o tamanho do buffer necessário. Depois que o tamanho do buffer necessário for determinado, uma segunda chamada GetFileExtensions com cchFileExtensions definida como o tamanho do buffer e wzFileExtensions definido como um buffer do tamanho apropriado recuperará os formatos de pixel.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincodec.h
Biblioteca Windowscodecs.lib