Freigeben über


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)

Weitere Informationen

MONITORINFO

MONITORINFOEX

Funktionen für mehrere Anzeigemonitore

Übersicht über mehrere Bildschirme