GetMonitorInfoA-Funktion (winuser.h)
Die GetMonitorInfo Funktion ruft Informationen zu einem Anzeigemonitor ab.
Syntax
BOOL GetMonitorInfoA(
[in] HMONITOR hMonitor,
[out] LPMONITORINFO lpmi
);
Parameter
[in] hMonitor
Ein Handle auf dem Bildschirm von Interesse.
[out] lpmi
Ein Zeiger auf eine MONITORINFO- oder MONITORINFOEX- Struktur, die Informationen über den angegebenen Anzeigemonitor empfängt.
Sie müssen das 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 fehlschlägt, ist der Rückgabewert null.
Bemerkungen
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winuser.h (enthalten Windows.h) |
| Library | User32.lib |
| DLL- | User32.dll |
| API-Satz | ext-ms-win-ntuser-sysparams-ext-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393) |