Метод IWICBitmapEncoder::CreateNewFrame (wincodec.h)

  • Статья

Создает новый экземпляр IWICBitmapFrameEncode .

Синтаксис

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

Параметры

[out] ppIFrameEncode

Тип: IWICBitmapFrameEncode**

Указатель, получающий указатель на новый экземпляр IWICBitmapFrameEncode.

[in, out] ppIEncoderOptions

Тип: IPropertyBag2**

Необязательный элемент. Получает именованные свойства, используемые для последующей инициализации кадра. См. заметки.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Параметр ppIEncoderOptions можно использовать для получения IPropertyBag2 , который затем можно использовать для указания параметров кодировщика. Это делается путем передачи указателя на указатель NULL IPropertyBag2 в ppIEncoderOptions. Возвращаемый объект IPropertyBag2 инициализируется со всеми параметрами кодировщика, доступными для заданного формата, со значениями по умолчанию. Чтобы указать поведение кодировки, отличное от используемого по умолчанию, задайте необходимые параметры кодировщика в IPropertyBag2 и передайте их в IWICBitmapFrameEncode::Initialize.

Примечание Не передайте указатель на инициализированный IPropertyBag2. Указатель будет перезаписан, и исходный IPropertyBag2 не будет освобожден.
 
В противном случае можно передать значение NULL в ppIEncoderOptions , если вы не планируете указывать параметры кодировщика.

Пример настройки параметров кодировщика см. в разделе Общие сведения о кодировании .

Для форматов, поддерживающих кодирование нескольких кадров (например, TIFF, JPEG-XR), можно работать только с одним кадром за раз. Это означает, что перед повторным вызовом CreateNewFrame необходимо вызвать IWICBitmapFrameEncode::Commit.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header wincodec.h
Библиотека Windowscodecs.lib
DLL Windowscodecs.dll

См. также раздел

Общие сведения о кодировке

IPropertyBag2

IWICBitmapEncoder