SetMonitorDisplayAreaPosition-Funktion (highlevelmonitorconfigurationapi.h)
Warnung
Die Konfigurationsfunktionen des physischen Monitors arbeiten 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 beabsichtigt funktionieren.
Legt die horizontale oder vertikale Position des Anzeigebereichs eines Monitors fest.
Wenn Sie die horizontale Position erhöhen, wird der Anzeigebereich auf die rechte Seite des Bildschirms verschoben. Wenn sie verkleinern, wird der Anzeigebereich nach links verschoben. Wenn Sie die vertikale Position erhöhen, wird der Anzeigebereich nach oben auf dem Bildschirm verschoben. Verkleinern verschiebt den Anzeigebereich nach unten.
Syntax
_BOOL SetMonitorDisplayAreaPosition(
[in] HANDLE hMonitor,
[in] MC_POSITION_TYPE ptPositionType,
[in] DWORD dwNewPosition
);
Parameter
[in] hMonitor
Handle für einen physischen Monitor. Rufen Sie zum Abrufen des Monitorhandles GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.
[in] ptPositionType
Ein Member der MC_POSITION_TYPE-Enumeration , der angibt, ob die horizontale oder die vertikale Position festgelegt werden soll.
[in] dwNewPosition
Horizontale oder vertikale Position. Rufen Sie GetMonitorDisplayAreaPosition auf, um die minimale und maximale Position zu erhalten.
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_POSITION zurück.
Die Rückgabe dieser Funktion dauert etwa 50 Millisekunden.
Die horizontale und vertikale Position 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 |