IWICImagingFactory：：CreateEncoder 方法 (wincodec.h)

  • 项目

创建 IWICBitmapEncoder 类的新实例。

语法

HRESULT CreateEncoder(
  [in]           REFGUID           guidContainerFormat,
  [in, optional] const GUID        *pguidVendor,
  [out, retval]  IWICBitmapEncoder **ppIEncoder
);

参数

[in] guidContainerFormat

类型： REFGUID

所需容器格式的 GUID。

值 含义
GUID_ContainerFormatBmp
 BMP 容器格式 GUID。
GUID_ContainerFormatPng
 PNG 容器格式 GUID。
GUID_ContainerFormatIco
 ICO 容器格式 GUID。
GUID_ContainerFormatJpeg
 JPEG 容器格式 GUID。
GUID_ContainerFormatTiff
 TIFF 容器格式 GUID。
GUID_ContainerFormatGif
 GIF 容器格式 GUID。
GUID_ContainerFormatWmp
 HD 照片容器格式 GUID。

[in, optional] pguidVendor

类型： const GUID*

首选编码器供应商的 GUID。

值 含义
Null
 没有首选编解码器供应商。
GUID_VendorMicrosoft
 首选使用 Microsoft 编码器。
GUID_VendorMicrosoftBuiltIn
 首选使用本机 Microsoft 编码器。

[out, retval] ppIEncoder

类型： IWICBitmapEncoder**

一个指针，用于接收指向新 IWICBitmapEncoder 的指针。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

其他值可能同时适用于 guidContainerFormat 和 pguidVendor ，具体取决于已安装的已启用 WIC 的编码器。 列出的值是操作系统本机支持的那些值。

要求

要求 值
最低受支持的客户端 Windows XP SP2，Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 wincodec.h
Library Windowscodecs.lib
DLL Windowscodecs.dll

另请参阅

IWICImagingFactory

WIC GUID 和 CLSID