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

Solicita que el codificador use el formato de píxel especificado.

Sintaxis

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

Parámetros

[in, out] pPixelFormat

Tipo: WICPixelFormatGUID*

En la entrada, el GUID de formato de píxel solicitado. En la salida, el GUID de formato de píxel más cercano admitido por el codificador; puede ser diferente del formato solicitado. Para obtener una lista de GUID de formato de píxel, consulte Formatos de píxeles nativos.

Valor devuelto

Tipo: HRESULT

Entre los valores devueltos posibles se incluyen los siguientes.

Código devuelto	Descripción
S_OK	Correcto.
WINCODEC_ERR_WRONGSTATE	No se llamó al método IWICBitmapFrameEncode::Initialize .

Comentarios

Es posible que el codificador no admita el formato de píxel solicitado. Si no es así, SetPixelFormat devuelve la coincidencia más cercana en el bloque de memoria al que apunta pPixelFormat . Si el formato de píxel devuelto no coincide con el formato solicitado, debe usar un objeto IWICFormatConverter para convertir los datos de píxeles.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincodec.h
Library	Windowscodecs.lib
Archivo DLL	Windowscodecs.dll

Consulte también

IWICBitmapFrameEncode

Formatos de píxeles nativos