Método IWICBitmapEncoder::CreateNewFrame (wincodec.h)

Crea una nueva instancia de IWICBitmapFrameEncode .

Sintaxis

HRESULT CreateNewFrame(
  [out]     IWICBitmapFrameEncode **ppIFrameEncode,
  [in, out] IPropertyBag2         **ppIEncoderOptions
);

Parámetros

[out] ppIFrameEncode

Tipo: IWICBitmapFrameEncode**

Puntero que recibe un puntero a la nueva instancia de IWICBitmapFrameEncode.

[in, out] ppIEncoderOptions

Tipo: IPropertyBag2**

Opcional. Recibe las propiedades con nombre que se van a usar para la inicialización de fotogramas posterior. Vea la sección Comentarios.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El parámetro ppIEncoderOptions se puede usar para recibir un IPropertyBag2 que, a continuación, se puede usar para especificar las opciones del codificador. Para ello, se pasa un puntero a un puntero IPropertyBag2 NULL en ppIEncoderOptions. IPropertyBag2 devuelto se inicializa con todas las opciones de codificador que están disponibles para el formato especificado, en sus valores predeterminados. Para especificar el comportamiento de codificación no predeterminado, establezca las opciones de codificador necesarias en IPropertyBag2 y pásela a IWICBitmapFrameEncode::Initialize.

Consulte Introducción a la codificación para obtener un ejemplo de cómo establecer las opciones del codificador.

En el caso de los formatos que admiten la codificación de varios fotogramas (por ejemplo, TIFF, JPEG-XR), puede trabajar solo en un fotograma cada vez. Esto significa que debe llamar a IWICBitmapFrameEncode::Commit antes de volver a llamar a CreateNewFrame .

Requisitos

Consulte también

Introducción a la codificación

IPropertyBag2

IWICBitmapEncoder