GetMonitorCapabilities function (highlevelmonitorconfigurationapi.h)
Warning
The physical monitor configuration functions work using the VESA Monitor Control Command Set (MCCS) standard over an I2C interface. Many monitors don't fully implement that standard; so your use of these commands might result in undefined monitor behavior. We don't recommend using these functions for arbitrary monitors without physically validating that they work as intended.
Retrieves the configuration capabilities of a monitor. Call this function to find out which high-level monitor configuration functions are supported by the monitor.
Syntax
_BOOL GetMonitorCapabilities(
[in] HANDLE hMonitor,
[out] LPDWORD pdwMonitorCapabilities,
[out] LPDWORD pdwSupportedColorTemperatures
);
Parameters
[in] hMonitor
Handle to a physical monitor. To get the monitor handle, call GetPhysicalMonitorsFromHMONITOR or GetPhysicalMonitorsFromIDirect3DDevice9.
[out] pdwMonitorCapabilities
Receives a bitwise OR of capabilities flags. See Remarks.
[out] pdwSupportedColorTemperatures
Receives a bitwise OR of color temperature flags. See Remarks.
Return value
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE. To get extended error information, call GetLastError.
The function fails if the monitor does not support DDC/CI.
Remarks
The capabilities flags returned in pdwMonitorCapabilities specify which high-level monitor configuration functions are supported by the monitor. They also specify how certain functions behave. The following capabilities flags are defined.
| Value | Description |
|---|---|
| MC_CAPS_BRIGHTNESS | The monitor supports the GetMonitorBrightness and SetMonitorBrightness functions. |
| MC_CAPS_COLOR_TEMPERATURE | The monitor supports the GetMonitorColorTemperature and SetMonitorColorTemperature functions. |
| MC_CAPS_CONTRAST | The monitor supports the GetMonitorContrast and SetMonitorContrast functions. |
| MC_CAPS_DEGAUSS | The monitor supports the DegaussMonitor function. |
| MC_CAPS_DISPLAY_AREA_POSITION | The monitor supports the GetMonitorDisplayAreaPosition and SetMonitorDisplayAreaPosition functions. |
| MC_CAPS_DISPLAY_AREA_SIZE | The monitor supports the GetMonitorDisplayAreaSize and SetMonitorDisplayAreaSize functions. |
| MC_CAPS_MONITOR_TECHNOLOGY_TYPE | The monitor supports the GetMonitorTechnologyType function. |
| MC_CAPS_NONE | The monitor does not support any monitor settings. |
| MC_CAPS_RED_GREEN_BLUE_DRIVE | The monitor supports the GetMonitorRedGreenOrBlueDrive and SetMonitorRedGreenOrBlueDrive functions. |
| MC_CAPS_RED_GREEN_BLUE_GAIN | The monitor supports the GetMonitorRedGreenOrBlueGain and SetMonitorRedGreenOrBlueGain functions. |
| MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS | The monitor supports the RestoreMonitorFactoryColorDefaults function. |
| MC_CAPS_RESTORE_FACTORY_DEFAULTS | The monitor supports the RestoreMonitorFactoryDefaults function. |
| MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS | If this flag is present, calling the RestoreMonitorFactoryDefaults function enables all of the monitor settings used by the high-level monitor configuration functions. For more information, see the Remarks section in RestoreMonitorFactoryDefaults. |
The color temperature flags returned in pdwSupportedColorTemperatures specify which color temperatures are supported by the monitor. The following color temperature flags are defined.
| Value | Description |
|---|---|
| MC_SUPPORTED_COLOR_TEMPERATURE_NONE | No color temperatures are supported. |
| MC_SUPPORTED_COLOR_TEMPERATURE_4000K | The monitor supports 4,000 kelvins (K) color temperature. |
| MC_SUPPORTED_COLOR_TEMPERATURE_5000K | The monitor supports 5,000 K color temperature. |
| MC_SUPPORTED_COLOR_TEMPERATURE_6500K | The monitor supports 6,500 K color temperature. |
| MC_SUPPORTED_COLOR_TEMPERATURE_7500K | The monitor supports 7,500 K color temperature. |
| MC_SUPPORTED_COLOR_TEMPERATURE_8200K | The monitor supports 8,200 K color temperature. |
| MC_SUPPORTED_COLOR_TEMPERATURE_9300K | The monitor supports 9,300 K color temperature. |
| MC_SUPPORTED_COLOR_TEMPERATURE_10000K | The monitor supports 10,000 K color temperature. |
| MC_SUPPORTED_COLOR_TEMPERATURE_11500K | The monitor supports 11,500 K color temperature. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | highlevelmonitorconfigurationapi.h |
| Library | Dxva2.lib |
| DLL | Dxva2.dll |