IWICBitmapFrameDecode：：GetColorContexts 方法 (wincodec.h)

检索与图像帧关联的 IWICColorContext 。

语法

HRESULT GetColorContexts(
  [in]      UINT             cCount,
  [in, out] IWICColorContext **ppIColorContexts,
  [out]     UINT             *pcActualCount
);

参数

[in] cCount

类型： UINT

要检索的颜色上下文的数量。

此值的大小必须为或小于 ppIColorContexts 可用的大小。

[in, out] ppIColorContexts

类型： IWICColorContext**

接收指向 IWICColorContext 对象的指针的指针。

[out] pcActualCount

类型： UINT*

接收图像帧中包含的颜色上下文数的指针。

返回值

类型： HRESULT

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

注解

如果为 ppIColorContexts 传递 NULL，并为 cCount 传递 0，则此方法将返回 pcActualCount 中图像中的颜色上下文总数。

ppIColorContexts 数组必须使用有效数据填充：数组中的每个 IWICColorContext* 都必须是使用 IWICImagingFactory：：CreateColorContext 创建的。

要求

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