MonitorFromPoint function (winuser.h)

The MonitorFromPoint function retrieves a handle to the display monitor that contains a specified point.

Syntax

C++

HMONITOR MonitorFromPoint(
  [in] POINT pt,
  [in] DWORD dwFlags
);

[in] pt

A POINT structure that specifies the point of interest in virtual-screen coordinates.

[in] dwFlags

Determines the function's return value if the point is not contained within any display monitor.

This parameter can be one of the following values.

Value	Meaning
MONITOR_DEFAULTTONULL 0x00000000	Returns NULL.
MONITOR_DEFAULTTOPRIMARY 0x00000001	Returns a handle to the primary display monitor.
MONITOR_DEFAULTTONEAREST 0x00000002	Returns a handle to the display monitor that is nearest to the point.

If the point is contained by a display monitor, the return value is an HMONITOR handle to that display monitor.

If the point is not contained by a display monitor, the return value depends on the value of dwFlags.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll
API set	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (introduced in Windows 10, version 10.0.14393)