Compartilhar via


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