IWICImagingFactory：：CreateDecoderFromFilename 方法 (wincodec.h)

  • 项目

基于给定文件创建 IWICBitmapDecoder 类的新实例。

语法

HRESULT CreateDecoderFromFilename(
  [in]          LPCWSTR           wzFilename,
  [in]          const GUID        *pguidVendor,
  [in]          DWORD             dwDesiredAccess,
  [in]          WICDecodeOptions  metadataOptions,
  [out, retval] IWICBitmapDecoder **ppIDecoder
);

参数

[in] wzFilename

类型： LPCWSTR

指向以 null 结尾的字符串的指针，该字符串指定要创建或打开的对象的名称。

[in] pguidVendor

类型： const GUID*

首选解码器供应商的 GUID。 如果没有首选供应商，请使用 NULL 。

[in] dwDesiredAccess

类型：DWORD

对 对象的访问，可以是读取和/或写入。

值 含义
GENERIC_READ
 读取访问权限。
GENERIC_WRITE
 写入访问权限。
 

有关详细信息，请参阅 通用访问权限。

[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