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

Recupera os formatos de pixel compatíveis com o codec.

Sintaxe

HRESULT GetPixelFormats(
  [in]      UINT cFormats,
  [in, out] GUID *pguidPixelFormats,
  [out]     UINT *pcActual
);

Parâmetros

[in] cFormats

Tipo: UINT

O tamanho da matriz pguidPixelFormats . Use 0 na primeira chamada para determinar o tamanho necessário da matriz.

[in, out] pguidPixelFormats

Tipo: GUID*

Recebe os formatos de pixel com suporte. Use NULL na primeira chamada para determinar o tamanho necessário da matriz.

[out] pcActual

Tipo: UINT*

O tamanho da matriz necessário para recuperar todos os formatos de pixel com suporte.

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

O padrão de uso desse método é um processo de duas chamadas. A primeira chamada recupera o tamanho da matriz necessária para recuperar todos os formatos de pixel com suporte chamando-o com cFormats definido 0 como e pguidPixelFormats definido NULLcomo . Essa chamada define pcActual para o tamanho da matriz necessário. Depois que o tamanho da matriz necessário for determinado, uma segunda chamada GetPixelFormats com pguidPixelFormats definida como uma matriz 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
DLL	Windowscodecs.dll