GetMonitorInfoW-Funktion (winuser.h)

Die GetMonitorInfo-Funktion ruft Informationen zu einem Anzeigemonitor ab.

Syntax

BOOL GetMonitorInfoW(
  [in]  HMONITOR      hMonitor,
  [out] LPMONITORINFO lpmi
);

Parameter

[in] hMonitor

Ein Handle für den anzeigemonitor von Interesse.

[out] lpmi

Ein Zeiger auf eine MONITORINFO- oder MONITORINFOEX-Struktur , die Informationen über den angegebenen Anzeigemonitor empfängt.

Sie müssen den cbSize-Member der Struktur auf sizeof(MONITORINFO) oder sizeof(MONITORINFOEX) festlegen, bevor Sie die GetMonitorInfo-Funktion aufrufen. Auf diese Weise kann die Funktion den Typ der Struktur bestimmen, die Sie an sie übergeben.

Die MONITORINFOEX-Struktur ist eine Obermenge der MONITORINFO-Struktur . Es verfügt über ein zusätzliches Element: eine Zeichenfolge, die einen Namen für den Anzeigemonitor enthält. Die meisten Anwendungen haben keine Verwendung für einen Anzeigemonitornamen und können daher einige Bytes mithilfe einer MONITORINFO-Struktur speichern.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Hinweis

Der winuser.h-Header definiert GetMonitorInfo als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

MONITORINFO

MONITORINFOEX

Funktionen für mehrere Anzeigemonitore

Übersicht über mehrere Anzeigemonitore