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 。

要求