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 |
|---|---|
|
Êxito. |
|
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 |