Поделиться через


Метод IWICImagingFactory::CreateEncoder (wincodec.h)

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

Синтаксис

HRESULT CreateEncoder(
  [in]           REFGUID           guidContainerFormat,
  [in, optional] const GUID        *pguidVendor,
  [out, retval]  IWICBitmapEncoder **ppIEncoder
);

Параметры

[in] guidContainerFormat

Тип: REFGUID

GUID для требуемого формата контейнера.

Значение Значение
GUID_ContainerFormatBmp
GUID формата контейнера BMP.
GUID_ContainerFormatPng
GUID формата PNG-контейнера.
GUID_ContainerFormatIco
GUID контейнера ICO.
GUID_ContainerFormatJpeg
GUID контейнера JPEG.
GUID_ContainerFormatTiff
Guid формата контейнера TIFF.
GUID_ContainerFormatGif
GUID формата GIF-контейнера.
GUID_ContainerFormatWmp
GUID контейнера hd Photo.

[in, optional] pguidVendor

Тип: const GUID*

GUID для предпочтительного поставщика кодировщика.

Значение Значение
NULL
Нет предпочтительного поставщика кодека.
GUID_VendorMicrosoft
Предпочитать использовать кодировщик Майкрософт.
GUID_VendorMicrosoftBuiltIn
Предпочитать использовать собственный кодировщик Майкрософт.

[out, retval] ppIEncoder

Тип: IWICBitmapEncoder**

Указатель, получающий указатель на новый IWICBitmapEncoder.

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

Тип: HRESULT

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

Комментарии

Другие значения могут быть доступны как для guidContainerFormat , так и для pguidVendor в зависимости от установленных кодировщиков с поддержкой WIC. Перечисленные значения — это значения, которые изначально поддерживаются операционной системой.

Требования

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

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

IWICImagingFactory

ИДЕНТИФИКАТОРы GUID WIC и CLSID