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 SP2、Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 wincodec.h
Library Windowscodecs.lib
DLL Windowscodecs.dll

另请参阅

CreateFile

IWICImagingFactory