GetMonitorCapabilities 函数 (highlevelmonitorconfigurationapi.h)
警告
物理监视器配置功能通过 I2C 接口使用 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 |