IWICBitmapFrameEncode：：SetColorContexts 方法 (wincodec.h)

  • 项目

将给定数目 的 IWICColorContext 配置文件设置为帧。

语法

HRESULT SetColorContexts(
  [in] UINT             cCount,
  [in] IWICColorContext **ppIColorContext
);

参数

[in] cCount

类型： UINT

要设置的 IWICColorContext 配置文件的数目。

[in] ppIColorContext

类型： IWICColorContext**

指向 IWICColorContext 指针的指针，该指针包含要设置为帧的颜色上下文配置文件。

返回值

类型： HRESULT

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

注解

  • Bmp不支持设置颜色上下文。 此函数将返回 WINCODEC_ERR_UNSUPPORTEDOPERATION。
  • Png最多支持设置一个颜色上下文，并且将忽略其他颜色上下文。 此上下文必须是 WICColorContextProfile，用于对 PNG 文件中的 iCCP、gAMA 和 cHRM 区块进行编码。
  • JPEG、TIFF、JPEG-XR支持设置一个 WICColorContextProfile 和一个 WICColorContextExifColorSpace 。 用户不能提供每种颜色上下文中的多个，因为除每种类型的最后一个上下文之外的所有上下文都将被忽略。 在 JPEG 中， WICColorContextProfile 编码为 JPEG APP2 ICC 元数据块。

    在 TIFF 和 JPEG-XR 中， WICColorContextProfile 被编码为 IFD ICC 配置文件元数据块， (IFD 标记0x8773) 。 在所有三种格式中， WICColorContextExifColorSpace 将编码为 EXIF 颜色空间元数据块， (EXIF 标记0xA001) 。

要求

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