通过

IWICDevelopRaw：：SetWhitePointKelvin 方法 (wincodec.h)

  • 项目

设置白点开尔文值。

语法

HRESULT SetWhitePointKelvin(
  [in] UINT WhitePointKelvin
);

参数

[in] WhitePointKelvin

类型： UINT

白点开尔文值。 可接受的开尔文值为 1,500 到 30,000。

返回值

类型： HRESULT

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

注解

编解码器实施者应忠实地调整原始图像本身支持的范围内的色温。 对于本机支持范围之外的值，编解码器实施者应尽最大努力在该色温下提供图像的表示形式。

如果值超过定义的可接受范围，编解码器实现程序应返回 WINCODEC_ERR_VALUEOUTOFRANGE 。

编解码器实现者必须确保与其他白点设置方法（如 SetWhitePointRGB）的正确互操作性。 例如，如果调用方通过 SetNamedWhitePoint 设置白点，则编解码器实施者可能希望禁用读回相应的开尔文温度。 在编解码器实现者希望由于先前调用而拒绝给定操作的特定情况下，应返回 WINCODEC_ERR_WRONGSTATE 。

要求

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