GetMonitorDisplayAreaPosition-Funktion (highlevelmonitorconfigurationapi.h)
Warnung
Die Konfigurationsfunktionen des physischen Monitors funktionieren mit dem VESA Monitor Control Command Set (MCCS)-Standard über eine I2C-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 vorgesehen funktionieren.
Ruft die minimale, maximale und aktuelle horizontale oder vertikale Position eines Monitors ab.
Syntax
_BOOL GetMonitorDisplayAreaPosition(
[in] HANDLE hMonitor,
[in] MC_POSITION_TYPE ptPositionType,
[out] LPDWORD pdwMinimumPosition,
[out] LPDWORD pdwCurrentPosition,
[out] LPDWORD pdwMaximumPosition
);
Parameter
[in] hMonitor
Handle mit einem physischen Monitor. Um das Monitorhandle abzurufen, rufen Sie GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.
[in] ptPositionType
Ein Element der MC_POSITION_TYPE-Enumeration , das angibt, ob die horizontale Position oder die vertikale Position abgerufen werden soll.
[out] pdwMinimumPosition
Empfängt die minimale horizontale oder vertikale Position.
[out] pdwCurrentPosition
Empfängt die aktuelle horizontale oder vertikale Position.
[out] pdwMaximumPosition
Empfängt die maximale horizontale oder vertikale Position.
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 MC_CAPS_DISPLAY_AREA_POSITION-Flag zurück.
Die Rückgabe dieser Funktion dauert etwa 40 Millisekunden.
Die horizontale und vertikale Position sind fortlaufende Monitoreinstellungen. Weitere Informationen finden Sie unter Verwenden der High-Level Monitorkonfigurationsfunktionen.
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 |