SetMonitorRedGreenOrBlueGain-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 den roten, grünen oder blauen Verstärkungswert eines Monitors fest.
Syntax
_BOOL SetMonitorRedGreenOrBlueGain(
[in] HANDLE hMonitor,
[in] MC_GAIN_TYPE gtGainType,
[in] DWORD dwNewGain
);
Parameter
[in] hMonitor
Handle für einen physischen Monitor. Rufen Sie zum Abrufen des Monitorhandles GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.
[in] gtGainType
Ein Member der MC_GAIN_TYPE-Enumeration , der angibt, ob der rote, grüne oder blaue Verstärkung festgelegt werden soll.
[in] dwNewGain
Rot, grün oder blau erhalten einen Wert. Rufen Sie GetMonitorRedGreenOrBlueGain auf, um die minimalen und maximalen Verstärkungswerte 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
Verstärkungseinstellungen werden in der Regel verwendet, um den Weißpunkt des Monitors anzupassen.
Wenn diese Funktion unterstützt wird, gibt die GetMonitorCapabilities-Funktion das flag MC_CAPS_RED_GREEN_BLUE_GAIN zurück.
Die Rückgabe dieser Funktion dauert etwa 50 Millisekunden.
Das Ändern der Verstärkungseinstellungen kann die Farbtemperatur ändern. Rufen Sie GetMonitorColorTemperature auf, um die neue Farbtemperatur zu erhalten.
Die Verstärkungseinstellungen sind Einstellungen für fortlaufende Überwachung. 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 |