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 für den anzeigemonitor von Interesse.
[out] lpmi
Ein Zeiger auf eine MONITORINFO- oder MONITORINFOEX-Struktur, die Informationen zum angegebenen Anzeigemonitor empfängt.
Sie müssen das cbSize-Element 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 Übermenge der MONITORINFO-Struktur . Sie 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 automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| 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 (einschließlich Windows.h) |
| 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) |