Compartir a través de

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

  • Artículo

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.

Nota No pase un puntero a un IPropertyBag2 inicializado. El puntero se sobrescribirá y el IPropertyBag2 original no se liberará.
 
De lo contrario, puede pasar NULL en ppIEncoderOptions si no tiene previsto especificar las opciones del codificador.

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

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

Introducción a la codificación

IPropertyBag2

IWICBitmapEncoder