SetMonitorColorTemperature 函数 (highlevelmonitorconfigurationapi.h)
警告
物理监视器配置函数通过 I2C 接口使用 VESA 监视器控制命令集 (MCCS) 标准。 许多监视器没有完全实现该标准;因此,使用这些命令可能会导致未定义的监视器行为。 建议不要将这些函数用于任意监视器,而不通过物理验证它们是否按预期工作。
设置监视器的色温。
语法
_BOOL SetMonitorColorTemperature(
[in] HANDLE hMonitor,
[in] MC_COLOR_TEMPERATURE ctCurrentColorTemperature
);
parameters
[in] hMonitor
物理监视器的句柄。 若要获取监视器句柄,请调用 GetPhysicalMonitorsFromHMONITOR 或 GetPhysicalMonitorsFromIDirect3DDevice9。
[in] ctCurrentColorTemperature
色温,指定为 MC_COLOR_TEMPERATURE 枚举的成员。
返回值
如果函数成功,则返回值为 TRUE。 如果函数失败,则返回值为 FALSE。 要获得更多的错误信息,请调用 GetLastError。
注解
如果支持此函数, GetMonitorCapabilities 函数将返回MC_CAPS_COLOR_TEMPERATURE标志。 GetMonitorCapabilities 函数还返回监视器支持的色温范围。 ctCurrentColorTemperature 参数必须对应于其中一个值。
更改色温会更改监视器的白点。 它还可以更改当前驱动器和增益设置。 若要获取新的驱动器和获取设置,请分别调用 GetMonitorRedGreenOrBlueDrive 和 GetMonitorRedGreenOrBlueGain。
此函数需要 50 到 90 毫秒才能返回。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | highlevelmonitorconfigurationapi.h |
Library | Dxva2.lib |
DLL | Dxva2.dll |