Export (0) Print
Expand All
Expand Minimize

GetMonitorCapabilities function

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

hMonitor [in]

Handle to a physical monitor. To get the monitor handle, call GetPhysicalMonitorsFromHMONITOR or GetPhysicalMonitorsFromIDirect3DDevice9.

pdwMonitorCapabilities [out]

Receives a bitwise OR of capabilities flags. See Remarks.

pdwSupportedColorTemperatures [out]

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_BRIGHTNESSThe monitor supports the GetMonitorBrightness and SetMonitorBrightness functions.
MC_CAPS_COLOR_TEMPERATUREThe monitor supports the GetMonitorColorTemperature and SetMonitorColorTemperature functions.
MC_CAPS_CONTRASTThe monitor supports the GetMonitorContrast and SetMonitorContrast functions.
MC_CAPS_DEGAUSSThe monitor supports the DegaussMonitor function.
MC_CAPS_DISPLAY_AREA_POSITIONThe monitor supports the GetMonitorDisplayAreaPosition and SetMonitorDisplayAreaPosition functions.
MC_CAPS_DISPLAY_AREA_SIZEThe monitor supports the GetMonitorDisplayAreaSize and SetMonitorDisplayAreaSize functions.
MC_CAPS_MONITOR_TECHNOLOGY_TYPEThe monitor supports the GetMonitorTechnologyType function.
MC_CAPS_NONEThe monitor does not support any monitor settings.
MC_CAPS_RED_GREEN_BLUE_DRIVEThe monitor supports the GetMonitorRedGreenOrBlueDrive and SetMonitorRedGreenOrBlueDrive functions.
MC_CAPS_RED_GREEN_BLUE_GAINThe monitor supports the GetMonitorRedGreenOrBlueGain and SetMonitorRedGreenOrBlueGain functions.
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTSThe monitor supports the RestoreMonitorFactoryColorDefaults function.
MC_CAPS_RESTORE_FACTORY_DEFAULTSThe monitor supports the RestoreMonitorFactoryDefaults function.
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGSIf 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_NONENo color temperatures are supported.
MC_SUPPORTED_COLOR_TEMPERATURE_4000KThe monitor supports 4,000 kelvins (K) color temperature.
MC_SUPPORTED_COLOR_TEMPERATURE_5000KThe monitor supports 5,000 K color temperature.
MC_SUPPORTED_COLOR_TEMPERATURE_6500KThe monitor supports 6,500 K color temperature.
MC_SUPPORTED_COLOR_TEMPERATURE_7500KThe monitor supports 7,500 K color temperature.
MC_SUPPORTED_COLOR_TEMPERATURE_8200KThe monitor supports 8,200 K color temperature.
MC_SUPPORTED_COLOR_TEMPERATURE_9300KThe monitor supports 9,300 K color temperature.
MC_SUPPORTED_COLOR_TEMPERATURE_10000KThe monitor supports 10,000 K color temperature.
MC_SUPPORTED_COLOR_TEMPERATURE_11500KThe monitor supports 11,500 K color temperature.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

HighLevelMonitorConfigurationAPI.h

Library

Dxva2.lib

DLL

Dxva2.dll

See also

Monitor Configuration Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft