SetMonitorColorTemperature-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 Farbtemperatur eines Monitors fest.
Syntax
_BOOL SetMonitorColorTemperature(
[in] HANDLE hMonitor,
[in] MC_COLOR_TEMPERATURE ctCurrentColorTemperature
);
Parameter
[in] hMonitor
Handle für einen physischen Monitor. Rufen Sie zum Abrufen des Monitorhandles GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.
[in] ctCurrentColorTemperature
Farbtemperatur, die als Member der MC_COLOR_TEMPERATURE-Enumeration angegeben wird.
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_COLOR_TEMPERATURE zurück. Die GetMonitorCapabilities-Funktion gibt auch den Farbtemperaturbereich zurück, den der Monitor unterstützt. Der ctCurrentColorTemperature-Parameter muss einem dieser Werte entsprechen.
Das Ändern der Farbtemperatur ändert den Weißpunkt des Monitors. Es kann auch die aktuelle Laufwerks- und Gain-Einstellungen ändern. Um das neue Laufwerk abzurufen und Einstellungen zu erhalten, rufen Sie GetMonitorRedGreenOrBlueDrive bzw . GetMonitorRedGreenOrBlueGain auf.
Die Rückgabe dieser Funktion dauert zwischen 50 und 90 Millisekunden.
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 |