Compartilhar via

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

  • Artigo

Recupera uma lista de GUIDs que significam quais formatos de pixel o conversor dá suporte.

Sintaxe

HRESULT GetPixelFormats(
  [in]      UINT               cFormats,
  [in, out] WICPixelFormatGUID *pPixelFormatGUIDs,
  [out]     UINT               *pcActual
);

Parâmetros

[in] cFormats

Tipo: UINT

O tamanho da matriz pPixelFormatGUIDs .

[in, out] pPixelFormatGUIDs

Tipo: WICPixelFormatGUID*

Ponteiro para uma matriz GUID que recebe os formatos de pixel aos quais o conversor dá suporte.

[out] pcActual

Tipo: UINT*

O tamanho real da matriz necessário para recuperar todos os formatos de pixel compatíveis com o conversor.

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 conversor de formato não garante necessariamente simetria em relação à conversão; ou seja, um conversor pode ser capaz de converter FROM de um formato específico sem realmente ser capaz de converter para um formato específico. Para testar a simetria, use CanConvert.

Para determinar o número de formatos de pixel que um conversor pode manipular, defina cFormats como 0 e pPixelFormatGUIDs como NULL. O conversor preencherá pcActual com o número de formatos compatíveis com esse conversor.

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