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
对 对象的访问,可以是读取和/或写入。
值 | 含义 |
---|---|
|
读取访问权限。 |
|
写入访问权限。 |
有关详细信息,请参阅 通用访问权限。
[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 |