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

Статья
03/03/2024

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

Синтаксис

HRESULT CreateDecoder(
  [in]          REFGUID           guidContainerFormat,
  [in]          const GUID        *pguidVendor,
  [out, retval] IWICBitmapDecoder **ppIDecoder
);

Параметры

[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] pguidVendor

Тип: const GUID*

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

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

[out, retval] ppIDecoder

Тип: IWICBitmapDecoder**

Указатель, получающий указатель на новый IWICBitmapDecoder. Этот IWICBitmapDecoder необходимо инициализировать в потоке с помощью метода Initialize позже.

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

Тип: 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