GetNumberOfPhysicalMonitors function

[!Important]
This function is used by the monitor configuration API to access functionality in the display driver. Applications should not call this function.

Gets the number of phyical monitors associated with a display device.

Syntax

NTSTATUS WINAPI GetNumberOfPhysicalMonitors(
  _In_  UNICODE_STRING *pstrDeviceName,
  _Out_ LPDWORD        pdwNumberOfPhysicalMonitors
);

Parameters

pstrDeviceName [in]

A pointer to a UNICODE_STRING structure that contains the name of the display device, as returned by the GetMonitorInfo function.

pdwNumberOfPhysicalMonitors [out]

Receives the number of physical monitors.

Return value

If the method succeeds, it returns STATUS_SUCCESS. Otherwise, it returns an NTSTATUS error code.

Remarks

Instead of using this function, applications should call one of the following functions:

This function has no associated import library. To call this function, you must use the LoadLibrary and GetProcAddress functions to dynamically link to Gdi32.dll.

Requirements

Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
DLL
Gdi32.dll

See also

Monitor Configuration Functions