Image::GetEncoderParameterList 方法 (gdiplusheaders.h)

Image::GetEncoderParameterList 方法获取指定图像编码器支持的参数列表。

语法

Status GetEncoderParameterList(
  [in]  const CLSID       *clsidEncoder,
  [in]  UINT              size,
  [out] EncoderParameters *buffer
);

参数

[in] clsidEncoder

类型: const CLSID*

指向指定编码器的 CLSID 的指针。

[in] size

类型: UINT

指定 缓冲区 数组的大小(以字节为单位)的整数。 调用 Image::GetEncoderParameterListSize 方法以获取所需的大小。

[out] buffer

类型: EncoderParameters*

指向接收受支持参数列表的 EncoderParameters 对象的指针。

返回值

类型: 状态

如果该方法成功,则返回 Ok,这是 Status 枚举的元素。

如果方法失败,它将返回 Status 枚举的其他元素之一。

注解

Image::GetEncoderParameterList 方法返回 EncoderParameter 对象的数组。 在调用 Image::GetEncoderParameterList 之前,必须分配一个足够大的缓冲区来接收该数组,该数组是 EncoderParameters 对象的一部分。 可以调用 Image::GetEncoderParameterListSize 方法来获取所需 EncoderParameters 对象的大小(以字节为单位)。

要求

要求
最低受支持的客户端 Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 gdiplusheaders.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

GetImageEncoders

GetImageEncodersSize

图像

Image::GetEncoderParameterListSize

使用图像编码器和解码器