Método IWICBitmapFrameEncode::SetPixelFormat (wincodec.h)

Solicita que o codificador use o formato de pixel especificado.

Sintaxe

HRESULT SetPixelFormat(
  [in, out] WICPixelFormatGUID *pPixelFormat
);

Parâmetros

[in, out] pPixelFormat

Tipo: WICPixelFormatGUID*

Na entrada, o GUID de formato de pixel solicitado. Na saída, o GUID de formato de pixel mais próximo com suporte do codificador; isso pode ser diferente do formato solicitado. Para obter uma lista de GUIDs de formato de pixel, consulte Formatos de pixel nativos.

Retornar valor

Tipo: HRESULT

Os possíveis valores retornados incluem o seguinte.

Código de retorno	Descrição
S_OK	Êxito.
WINCODEC_ERR_WRONGSTATE	O método IWICBitmapFrameEncode::Initialize não foi chamado.

Comentários

O codificador pode não dar suporte ao formato de pixel solicitado. Caso contrário, SetPixelFormat retornará a correspondência mais próxima no bloco de memória para o qual pPixelFormat aponta. Se o formato de pixel retornado não corresponder ao formato solicitado, você deverá usar um objeto IWICFormatConverter para converter os dados 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

Confira também

Iwicbitmapframeencode

Formatos de pixel nativos