SetMonitorBrightness-Funktion (highlevelmonitorconfigurationapi.h)

Warnung

Die Konfigurationsfunktionen des physischen Monitors funktionieren 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 vorgesehen funktionieren.

Legt den Helligkeitswert eines Monitors fest. Wenn Sie den Helligkeitswert erhöhen, wird die Anzeige auf dem Monitor heller, und die Verringerung der Anzeige wird abgeblendet.

Syntax

_BOOL SetMonitorBrightness(
  [in] HANDLE hMonitor,
  [in] DWORD  dwNewBrightness
);

Parameter

[in] hMonitor

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

[in] dwNewBrightness

Helligkeitswert. Rufen Sie GetMonitorBrightness auf, um die minimalen und maximalen Helligkeitswerte des Monitors abzurufen.

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_BRIGHTNESS-Flag zurück.

Die Rückgabe dieser Funktion dauert etwa 50 Millisekunden.

Die Helligkeitseinstellung ist eine kontinuierliche Monitoreinstellung. 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

Weitere Informationen

Überwachen von Konfigurationsfunktionen