RestoreMonitorFactoryDefaults 函数 (highlevelmonitorconfigurationapi.h)

警告

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

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

语法

_BOOL RestoreMonitorFactoryDefaults(
  [in] HANDLE hMonitor
);

parameters

[in] hMonitor

物理监视器的句柄。 若要获取监视器句柄,请调用 GetPhysicalMonitorsFromHMONITORGetPhysicalMonitorsFromIDirect3DDevice9

返回值

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

注解

此函数还原高级监视器配置函数支持的所有设置。 它还可能还原只能通过低级别函数使用且不受高级函数支持的设置。 每个设置的当前值更改为其出厂默认值。 更改的确切设置以及这些设置的默认值取决于制造商。 此函数还可以更改某些设置支持的值的范围。

如果支持此函数, GetMonitorCapabilities 函数将返回MC_CAPS_RESTORE_FACTORY_DEFAULTS标志。

此函数大约需要 5 秒才能返回。

如果 GetMonitorCapabilities 返回MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS标志,则此函数还会启用高级函数支持的所有监视器设置。 有时,应用程序可以通过调用低级别函数来禁用某些设置。 用户还可以通过调整监视器的物理控制面板上的设置来禁用某些设置。 如果发生这种情况,只能通过控制面板或调用 RestoreMonitorFactoryDefaults 重新启用设置。 无法使用高级函数禁用任何设置。

要求

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

另请参阅

监视配置函数

RestoreMonitorFactoryColorDefaults