IWICDevelopRaw::SetNamedWhitePoint 方法 (wincodec.h)

设置原始文件的命名白点。

语法

HRESULT SetNamedWhitePoint(
  [in] WICNamedWhitePoint WhitePoint
);

参数

[in] WhitePoint

类型: WICNamedWhitePoint

枚举值的按位组合。

返回值

类型: HRESULT

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

注解

如果原始图像不支持命名白点,或者原始文件包含此 API 不支持的命名白点,则编解码器实现者仍应将此功能标记为受支持。

如果原始图像不支持命名的白点,应尽力将图像调整为命名的白点,即使它不是原始文件的预定义白点也是如此。

如果原始文件包含此 API 不支持的命名白点,则编解码器实现程序应支持 API 中的命名白点。

由于其他白点设置方法 (例如 SetWhitePointKelvin) ,编解码器实现者必须小心以确保适当的互操作性。 例如,如果调用方通过命名白点设置,则编解码器实现者可能希望禁用读回相应的开氏温度。 在编解码器实现者希望由于以前的调用而拒绝给定操作的特定情况下,应返回 WINCODEC_ERR_WRONGSTATE

要求

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