使用 High-Level Monitor 配置函数
枚举物理监视器
有几个函数枚举显示设备,包括 EnumDisplayMonitors 和 MonitorFromWindow。 Windows GDI 文档中的 多个显示监视器主题下记录了这些函数。 这些函数返回 HMONITOR 句柄。 但是,尽管名称为 HMONITOR,但 HMONITOR 句柄可以与多个物理监视器相关联。 若要在监视器上配置设置,应用程序必须通过调用 GetPhysicalMonitorsFromHMONITOR 获取物理监视器的唯一句柄。
如果应用程序使用 Direct3D,可以通过调用 GetPhysicalMonitorsFromIDirect3DDevice9 从 Direct3D 设备获取监视器句柄。
支持的函数
监视器可能不支持所有监视器配置功能。 若要了解监视器支持哪些函数,请调用 GetMonitorCapabilities。
连续监视器设置
连续监视设置可以是一些最小值和最大值之间的设置。 大多数高级监视器配置函数控制连续监视设置。 例如,亮度和对比度是连续设置。
连续监视器设置没有定义实际单位。 这些单位是任意的,可以因制造商而异。 例如,如果两个监视器具有相同的亮度值,则一个监视器看起来可能比另一个更亮。 通常,应用程序会向用户显示滑块控件或上下控件。 然后,用户可以调整设置,以提供最佳的主观质量。
监视状态的更改
监视器可能会出于各种原因更改状态,包括:
- 用户使用监视器的前面板控件更改设置。
- 用户更改监视器的屏幕分辨率、刷新率或位深度。
- 应用程序使用低级别监视函数更改无法从高级函数访问的设置。
- 应用程序调用 RestoreMonitorFactoryColorDefaults 或 RestoreMonitorFactoryDefaults。
所有这些事件都可以更改监视器设置。 它们还可以更改设置的最小值和最大值。
监视器设置之间的依赖关系
更改色温可能会更改当前驱动器和增益设置,反之亦然。 这些是高级监视器配置函数中唯一的依赖项。 其他设置可能只能通过低级别监视器函数访问。 这些设置与高级设置之间可能存在依赖关系。 这些依赖项特定于供应商。 应用程序可以通过多种方式处理此问题:
- 仅使用高级函数。
- 调用低级别函数后,获取每个监视器设置的当前值。 遗憾的是,此方法可能很慢,因为获取每个设置大约需要 40 毫秒。
- 仅将低级别函数用于你了解其行为的特定监视模型。
禁用的监视器设置
应用程序无法通过调用高级监视器函数来禁用任何监视器设置。 但是,如果应用程序使用低级别函数更改高级函数不支持的监视设置,则应用程序可能会意外禁用该设置。 此外,用户还可以使用前面板控件禁用设置。 这些行为特定于供应商。
如果禁用监视器设置,则任何设置或检索该设置的函数都将失败,并将最后错误代码设置为ERROR_DISABLED_MONITOR_SETTING。 发生这种情况时,应用程序可以执行以下操作之一:
- 显示错误消息,并建议用户尝试使用前面板控件调整设置。
- 调用 RestoreMonitorFactoryDefaults 函数。 如果监视器具有MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS功能标志,则此函数将启用高级监视器函数支持的所有监视器设置。 遗憾的是,函数还会将监视器设置重置为其出厂默认设置。
相关主题