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