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

Статья
08/27/2023

Создает новый экземпляр класса 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

Share via