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