GetMonitorCapabilities 函数 (highlevelmonitorconfigurationapi.h)

警告

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

检索监视器的配置功能。调用此函数可找出监视器支持哪些高级监视器配置函数。

语法

_BOOL GetMonitorCapabilities(
  [in]  HANDLE  hMonitor,
  [out] LPDWORD pdwMonitorCapabilities,
  [out] LPDWORD pdwSupportedColorTemperatures
);

[in] hMonitor

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

[out] pdwMonitorCapabilities

接收按位或功能标志。请参阅“备注”。

[out] pdwSupportedColorTemperatures

接收颜色温度标志的按位 OR 。请参阅“备注”。

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

如果监视器不支持 DDC/CI，函数将失败。

pdwMonitorCapabilities 中返回的功能标志指定监视器支持哪些高级监视器配置函数。它们还指定某些函数的行为方式。定义了以下功能标志。

值	说明
MC_CAPS_BRIGHTNESS	监视器支持 GetMonitorBrightness 和 SetMonitorBrightness 函数。
MC_CAPS_COLOR_TEMPERATURE	监视器支持 GetMonitorColorTemperature 和 SetMonitorColorTemperature 函数。
MC_CAPS_CONTRAST	监视器支持 GetMonitorContrast 和 SetMonitorContrast 函数。
MC_CAPS_DEGAUSS	监视器支持 DegaussMonitor 函数。
MC_CAPS_DISPLAY_AREA_POSITION	监视器支持 GetMonitorDisplayAreaPosition 和 SetMonitorDisplayAreaPosition 函数。
MC_CAPS_DISPLAY_AREA_SIZE	监视器支持 GetMonitorDisplayAreaSize 和 SetMonitorDisplayAreaSize 函数。
MC_CAPS_MONITOR_TECHNOLOGY_TYPE	监视器支持 GetMonitorTechnologyType 函数。
MC_CAPS_NONE	监视器不支持任何监视器设置。
MC_CAPS_RED_GREEN_BLUE_DRIVE	监视器支持 GetMonitorRedGreenOrBlueDrive 和 SetMonitorRedGreenOrBlueDrive 函数。
MC_CAPS_RED_GREEN_BLUE_GAIN	监视器支持 GetMonitorRedGreenOrBlueGain 和 SetMonitorRedGreenOrBlueGain 函数。
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS	监视器支持 RestoreMonitorFactoryColorDefaults 函数。
MC_CAPS_RESTORE_FACTORY_DEFAULTS	监视器支持 RestoreMonitorFactoryDefaults 函数。
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS	如果存在此标志，则调用 RestoreMonitorFactoryDefaults 函数将启用高级监视器配置函数使用的所有监视器设置。有关详细信息，请参阅 RestoreMonitorFactoryDefaults 中的“备注”部分。

pdwSupportedColorTemperatures 中返回的颜色温度标志指定监视器支持的颜色温度。定义了以下颜色温度标志。

值	说明
MC_SUPPORTED_COLOR_TEMPERATURE_NONE	不支持色温。
MC_SUPPORTED_COLOR_TEMPERATURE_4000K	监视器支持 4,000 开文 (K) 色温。
MC_SUPPORTED_COLOR_TEMPERATURE_5000K	监视器支持 5,000 K 色温。
MC_SUPPORTED_COLOR_TEMPERATURE_6500K	监视器支持 6,500 K 色温。
MC_SUPPORTED_COLOR_TEMPERATURE_7500K	监视器支持 7,500 K 色温。
MC_SUPPORTED_COLOR_TEMPERATURE_8200K	监视器支持 8,200 K 色温。
MC_SUPPORTED_COLOR_TEMPERATURE_9300K	监视器支持 9,300 K 色温。
MC_SUPPORTED_COLOR_TEMPERATURE_10000K	监视器支持 10,000 K 色温。
MC_SUPPORTED_COLOR_TEMPERATURE_11500K	监视器支持 11,500 K 色温。

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