GetMonitorBrightness-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.
Ruft die Einstellungen für minimale, maximale und aktuelle Helligkeit eines Monitors ab.
Syntax
_BOOL GetMonitorBrightness(
[in] HANDLE hMonitor,
[out] LPDWORD pdwMinimumBrightness,
[out] LPDWORD pdwCurrentBrightness,
[out] LPDWORD pdwMaximumBrightness
);
Parameter
[in] hMonitor
Handle für einen physischen Monitor. Rufen Sie zum Abrufen des Monitorhandles GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.
[out] pdwMinimumBrightness
Empfängt die minimale Helligkeit des Monitors.
[out] pdwCurrentBrightness
Empfängt die aktuelle Helligkeit des Monitors.
[out] pdwMaximumBrightness
Empfängt die maximale Helligkeit des Monitors.
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_BRIGHTNESS zurück.
Die Rückgabe dieser Funktion dauert etwa 40 Millisekunden.
Die Helligkeitseinstellung ist eine Einstellung für einen kontinuierlichen Monitor. Weitere Informationen finden Sie unter Verwenden der High-Level Monitor-Konfigurationsfunktionen.
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 |