Export (0) Print
Expand All

GetMonitorInfo function

The GetMonitorInfo function retrieves information about a display monitor.

Syntax


BOOL GetMonitorInfo(
  _In_   HMONITOR hMonitor,
  _Out_  LPMONITORINFO lpmi
);

Parameters

hMonitor [in]

A handle to the display monitor of interest.

lpmi [out]

A pointer to a MONITORINFO or MONITORINFOEX structure that receives information about the specified display monitor.

You must set the cbSize member of the structure to sizeof(MONITORINFO) or sizeof(MONITORINFOEX) before calling the GetMonitorInfo function. Doing so lets the function determine the type of structure you are passing to it.

The MONITORINFOEX structure is a superset of the MONITORINFO structure. It has one additional member: a string that contains a name for the display monitor. Most applications have no use for a display monitor name, and so can save some bytes by using a MONITORINFO structure.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Examples

For an example, see Positioning Objects on a Multiple Display Setup.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

Unicode and ANSI names

GetMonitorInfoW (Unicode) and GetMonitorInfoA (ANSI)

See also

Multiple Display Monitors Overview
Multiple Display Monitors Functions
MONITORINFO
MONITORINFOEX

 

 

Community Additions

ADD
Show:
© 2014 Microsoft