IWICBitmapCodecInfo：：GetPixelFormats 方法 (wincodec.h)

检索编解码器支持的像素格式。

语法

HRESULT GetPixelFormats(
  [in]      UINT cFormats,
  [in, out] GUID *pguidPixelFormats,
  [out]     UINT *pcActual
);

参数

[in] cFormats

类型： UINT

pguidPixelFormats 数组的大小。 在第一次调用时使用 0 来确定所需的数组大小。

[in, out] pguidPixelFormats

类型： GUID*

接收支持的像素格式。 在第一次调用时使用 NULL 来确定所需的数组大小。

[out] pcActual

类型： UINT*

检索所有支持的像素格式所需的数组大小。

返回值

类型： HRESULT

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

注解

此方法的使用模式为两个调用过程。 第一个调用通过将 cFormats 设置为 ，pguidPixelFormatsNULL设置为 0 来检索检索所有支持的像素格式所需的数组大小。 此调用将 pcActual 设置为所需的数组大小。 确定所需的数组大小后，将 pguidPixelFormats 设置为适当大小的数组的第二个 GetPixelFormats 调用将检索像素格式。

要求

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