RestoreMonitorFactoryColorDefaults-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.
Stellt die Farbeinstellungen eines Monitors auf die Werkseinstellungen wieder her.
Syntax
_BOOL RestoreMonitorFactoryColorDefaults(
[in] HANDLE hMonitor
);
Parameter
[in] hMonitor
Handle für einen physischen Monitor. Rufen Sie zum Abrufen des Monitorhandles GetPhysicalMonitorsFromHMONITOR oder GetPhysicalMonitorsFromIDirect3DDevice9 auf.
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
Diese Funktion ändert möglicherweise den aktuellen Wert der Helligkeit, des Kontrasts, der Farbtemperatur, des Laufwerks und der Verstärkung des Monitors. Der aktuelle Wert jeder Einstellung wird in den Werksstandard geändert. Die Standardeinstellungen hängen vom Hersteller ab. Diese Funktion kann auch den Bereich der unterstützten Werte für jede dieser Einstellungen ändern. Die Funktion aktiviert keine deaktivierten Überwachungseinstellungen.
Wenn diese Funktion unterstützt wird, gibt die GetMonitorCapabilities-Funktion das flag MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS zurück. Die Rückgabe dieser Funktion dauert etwa 5 Sekunden.
Diese Funktion setzt möglicherweise Überwachungseinstellungen zurück, auf die nicht über die allgemeinen Überwachungskonfigurationsfunktionen zugegriffen werden kann. Ob dies geschieht, hängt vom jeweiligen Modell des Monitors ab.
Die folgenden Einstellungen sind von dieser Funktion nicht betroffen:
- Größe der Anzeigefläche
- Position des Anzeigebereichs
- Funktionenflags
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für