GetMonitorColorTemperature 函数 (highlevelmonitorconfigurationapi.h)

警告

物理监视器配置函数通过 I²C 接口使用 VESA 监视器控制命令集 (MCCS) 标准。许多监视器没有完全实现该标准;因此，使用这些命令可能会导致未定义的监视器行为。建议不要将这些函数用于任意监视器，而不通过物理验证它们是否按预期工作。

检索监视器的当前色温。

语法

_BOOL GetMonitorColorTemperature(
  [in]  HANDLE                 hMonitor,
  [out] LPMC_COLOR_TEMPERATURE pctCurrentColorTemperature
);

[in] hMonitor

物理监视器的句柄。若要获取监视器句柄，请调用 GetPhysicalMonitorsFromHMONITOR 或 GetPhysicalMonitorsFromIDirect3DDevice9。

[out] pctCurrentColorTemperature

接收监视器的当前色温，指定为 MC_COLOR_TEMPERATURE 枚举的成员。

如果函数成功，则返回值为 TRUE。如果函数失败，则返回值为 FALSE。要获得更多的错误信息，请调用 GetLastError。

如果支持此函数， GetMonitorCapabilities 函数将返回MC_CAPS_COLOR_TEMPERATURE标志。

此函数需要 0 到 80 毫秒才能返回。


最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	highlevelmonitorconfigurationapi.h
Library	Dxva2.lib
DLL	Dxva2.dll