Freigeben über

SetMonitorDisplayAreaSize-Funktion (highlevelmonitorconfigurationapi.h)

  • Artikel

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.

Legt die Breite oder Höhe des Anzeigebereichs eines Monitors fest.

Syntax

_BOOL SetMonitorDisplayAreaSize(
  [in] HANDLE       hMonitor,
  [in] MC_SIZE_TYPE stSizeType,
  [in] DWORD        dwNewDisplayAreaWidthOrHeight
);

Parameter

[in] hMonitor

Handle mit einem physischen Monitor. Um das Monitorhandle abzurufen, rufen Sie GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.

[in] stSizeType

Ein Element der MC_SIZE_TYPE-Enumeration , das angibt, ob die Breite oder die Höhe festgelegt werden soll.

[in] dwNewDisplayAreaWidthOrHeight

Breite oder Höhe des Anzeigebereichs. Rufen Sie GetMonitorDisplayAreaSize auf, um die minimale und maximale Breite und Höhe 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 MC_CAPS_DISPLAY_AREA_SIZE-Flag zurück.

Die Rückgabe dieser Funktion dauert etwa 50 Millisekunden.

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

Anforderungen

Anforderung Wert
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