Monitor GetMonitorDisplayAreaPosition Function 

  • Article
 
Monitor Configuration API
Previous Next

GetMonitorDisplayAreaPosition Function

Retrieves a monitor's minimum, maximum, and current horizontal or vertical position.

Syntax

  BOOL GetMonitorDisplayAreaPosition(
  HANDLE
    hMonitor,

    MC_POSITION_TYPE
    ptPositionType,

    LPDWORD
    pdwMinimumPosition,

    LPDWORD
    pdwCurrentPosition,

    LPDWORD
    pdwMaximumPosition

  );

Parameters

hMonitor

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

ptPositionType

[in]  A member of the MC_POSITION_TYPE enumeration, specifying whether to retrieve the horizontal position or the vertical position.

pdwMinimumPosition

[out]  Receives the minimum horizontal or vertical position.

pdwCurrentPosition

[out]  Receives the current horizontal or vertical position.

pdwMaximumPosition

[out]  Receives the maximum horizontal or vertical position.

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.

Remarks

If this function is supported, the GetMonitorCapabilities function returns the MC_CAPS_DISPLAY_AREA_POSITION flag.

This function takes about 40 milliseconds to return.

The horizontal and vertical position are continuous monitor settings. For more information, see Using the High-Level Monitor Configuration Functions.

Requirements

Client: Requires Windows Vista.

Header: Include HighLevelMonitorConfigurationAPI.h.

Library: Use dxva2.lib.

See Also

Previous Next