RestoreMonitorFactoryColorDefaults 函数 (highlevelmonitorconfigurationapi.h)

警告

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

将监视器的颜色设置还原为其出厂默认设置。

语法

_BOOL RestoreMonitorFactoryColorDefaults(
  [in] HANDLE hMonitor
);

[in] hMonitor

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

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

此函数可能会更改监视器亮度、对比度、色温、驱动器和增益的当前值。每个设置的当前值将更改为其出厂默认值。默认设置取决于制造商。此函数还可以更改其中每个设置支持的值的范围。函数不启用任何已禁用的监视器设置。

如果支持此函数， GetMonitorCapabilities 函数将返回 MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS 标志。此函数大约需要 5 秒才能返回。

此函数可能会重置无法通过高级监视器配置函数访问的监视器设置。是否发生这种情况取决于监视器的特定模型。

以下设置不受此函数影响：

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