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:

• GetNumberOfPhysicalMonitorsFromHMONITOR
• GetNumberOfPhysicalMonitorsFromIDirect3DDevice9

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

Requirement	Value
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