GetPhysicalMonitors-Funktion

Wichtig

Diese Funktion wird von der Monitorkonfigurations-API verwendet, um auf Funktionen im Anzeigetreiber zuzugreifen. Anwendungen sollten diese Funktion nicht aufrufen.

Ruft die physischen Monitore ab, die einem Anzeigegerät zugeordnet sind.

Syntax

NTSTATUS WINAPI GetPhysicalMonitors(
  _In_  UNICODE_STRING *pstrDeviceName,
  _In_  DWORD          dwPhysicalMonitorArraySize,
  _Out_ DWORD          *pdwNumPhysicalMonitorHandlesInArray,
  _Out_ HANDLE         *phPhysicalMonitorArray
);

Parameter

pstrDeviceName [in]

Ein Zeiger auf eine UNICODE_STRING Struktur, die den Namen des Anzeigegeräts enthält, wie von der GetMonitorInfo-Funktion zurückgegeben.

dwPhysicalMonitorArraySize [in]

Die Anzahl der Elemente im Array pdwNumPhysicalMonitorHandlesInArray . Rufen Sie GetNumberOfPhysicalMonitors auf, um die erforderliche Größe des Arrays abzurufen.

pdwNumPhysicalMonitorHandlesInArray [out]

Empfängt die Anzahl der Elemente, die die Funktion in das phPhysicalMonitorArray-Array kopiert.

phPhysicalMonitorArray [out]

Ein Array, das Handles für die physischen Monitore empfängt. Jedes Handle muss durch Aufrufen von DestroyPhysicalMonitor freigegeben werden.

Rückgabewert

Wenn die Methode erfolgreich ist, wird STATUS_SUCCESS zurückgegeben. Andernfalls wird ein NTSTATUS-Fehlercode zurückgegeben.

Bemerkungen

Anstatt diese Funktion zu verwenden, sollten Anwendungen eine der folgenden Funktionen aufrufen:

• GetPhysicalMonitorsFromHMONITOR
• GetPhysicalMonitorsFromIDirect3DDevice9

Diese Funktion verfügt über keine zugeordnete Importbibliothek. Um diese Funktion aufzurufen, müssen Sie die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Gdi32.dll zu verknüpfen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
DLL	Gdi32.dll

Siehe auch

Überwachen von Konfigurationsfunktionen