GetMonitorDisplayAreaSize-Funktion (highlevelmonitorconfigurationapi.h)

Artikel
08/24/2023

Warnung

Die Konfigurationsfunktionen des physischen Monitors arbeiten mit dem VESA Monitor Control Command Set (MCCS)-Standard über eine I²C-Schnittstelle. Viele Monitore implementieren diesen Standard nicht vollständig. Daher kann die Verwendung dieser Befehle zu einem nicht definierten Überwachungsverhalten führen. Es wird nicht empfohlen, diese Funktionen für beliebige Monitore zu verwenden, ohne physisch zu überprüfen, dass sie wie beabsichtigt funktionieren.

Ruft die minimale, maximale und aktuelle Breite oder Höhe eines Monitors ab.

Syntax

_BOOL GetMonitorDisplayAreaSize(
  [in]  HANDLE       hMonitor,
  [in]  MC_SIZE_TYPE stSizeType,
  [out] LPDWORD      pdwMinimumWidthOrHeight,
  [out] LPDWORD      pdwCurrentWidthOrHeight,
  [out] LPDWORD      pdwMaximumWidthOrHeight
);

Parameter

[in] hMonitor

Handle für einen physischen Monitor. Rufen Sie zum Abrufen des Monitorhandles GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.

[in] stSizeType

Ein Member der MC_SIZE_TYPE-Enumeration , der angibt, ob die Breite oder die Höhe abgerufen werden soll.

[out] pdwMinimumWidthOrHeight

Empfängt die mindeste Breite oder Höhe.

[out] pdwCurrentWidthOrHeight

Empfängt die aktuelle Breite oder Höhe.

[out] pdwMaximumWidthOrHeight

Empfängt die maximale Breite oder Höhe.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE. Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn diese Funktion unterstützt wird, gibt die GetMonitorCapabilities-Funktion das flag MC_CAPS_DISPLAY_AREA_SIZE zurück.

Die Rückgabe dieser Funktion dauert etwa 40 Millisekunden.

Die Einstellungen für Breite und Höhe sind fortlaufende Monitoreinstellungen. Weitere Informationen finden Sie unter Verwenden der High-Level Monitor-Konfigurationsfunktionen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	highlevelmonitorconfigurationapi.h
Bibliothek	Dxva2.lib
DLL	Dxva2.dll

Weitere Informationen

Überwachen von Konfigurationsfunktionen

Freigeben über