IWICFormatConverterInfo::GetPixelFormats 方法 (wincodec.h)

检索表示转换器支持的像素格式的 GUID 列表。

语法

HRESULT GetPixelFormats(
  [in]      UINT               cFormats,
  [in, out] WICPixelFormatGUID *pPixelFormatGUIDs,
  [out]     UINT               *pcActual
);

参数

[in] cFormats

类型: UINT

pPixelFormatGUIDs 数组的大小。

[in, out] pPixelFormatGUIDs

类型: WICPixelFormatGUID*

指向 GUID 数组的指针,该数组接收转换器支持的像素格式。

[out] pcActual

类型: UINT*

检索转换器支持的所有像素格式所需的实际数组大小。

返回值

类型: HRESULT

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

注解

格式转换器不一定保证转换的对称性;也就是说,转换器可能能够从特定格式转换,而实际上无法转换为特定格式。 若要测试对称性,请使用 CanConvert

若要确定转换器可以处理的像素格式数,请将 cFormats 设置为 0将 pPixelFormatGUID 设置为NULL。 转换器将使用该转换器支持的格式数填充 pcActual

要求

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