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

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

Синтаксис

HRESULT CreateDecoderFromFileHandle(
  [in]          ULONG_PTR         hFile,
  [in]          const GUID        *pguidVendor,
  [in]          WICDecodeOptions  metadataOptions,
  [out, retval] IWICBitmapDecoder **ppIDecoder
);

Параметры

[in] hFile

Тип: ULONG_PTR

Дескриптор файла для создания декодера.

[in] pguidVendor

Тип: const GUID*

Guid для предпочтительного поставщика декодера. Используйте значение NULL , если нет предпочтительного поставщика.

[in] metadataOptions

Тип: WICDecodeOptions

WICDecodeOptions, используемый при создании декодера.

[out, retval] ppIDecoder

Тип: IWICBitmapDecoder**

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

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

Тип: HRESULT

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

Комментарии

При создании декодера с помощью этого метода дескриптор файла должен оставаться активным в течение всего времени существования декодера.

Требования

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

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

CreateFile

IWICImagingFactory