RestoreMonitorFactoryDefaults-Funktion (highlevelmonitorconfigurationapi.h)

Warnung

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

Stellt die Einstellungen eines Monitors auf die Werkseinstellungen wieder her.

Syntax

_BOOL RestoreMonitorFactoryDefaults(
  [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

Mit dieser Funktion werden alle Einstellungen wiederhergestellt, die von den allgemeinen Überwachungskonfigurationsfunktionen unterstützt werden. Es kann auch Einstellungen wiederherstellen, die nur über die Funktionen auf niedriger Ebene verfügbar sind und von den funktionen der allgemeinen Ebene nicht unterstützt werden. Der aktuelle Wert jeder Einstellung wird in den Werksstandard geändert. Die genauen Einstellungen, die sich ändern, und die Standardwerte dieser Einstellungen hängen vom Hersteller ab. Diese Funktion kann auch den Bereich der unterstützten Werte für einige Einstellungen ändern.

Wenn diese Funktion unterstützt wird, gibt die GetMonitorCapabilities-Funktion das flag MC_CAPS_RESTORE_FACTORY_DEFAULTS zurück.

Die Rückgabe dieser Funktion dauert etwa 5 Sekunden.

Wenn GetMonitorCapabilities das flag MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS zurückgibt, aktiviert diese Funktion auch alle Überwachungseinstellungen, die von den allgemeinen Funktionen unterstützt werden. Es ist manchmal möglich, dass eine Anwendung bestimmte Einstellungen durch Aufrufen der Low-Level-Funktionen deaktiviert. Es ist auch möglich, dass der Benutzer bestimmte Einstellungen durch Anpassen der Einstellungen auf der physischen Systemsteuerung des Monitors deaktivieren kann. In diesem Fall kann die Einstellung nur über die Systemsteuerung oder durch Aufrufen von RestoreMonitorFactoryDefaults erneut aktiviert werden. Es ist nicht möglich, Einstellungen mithilfe der allgemeinen Funktionen zu deaktivieren.

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

RestoreMonitorFactoryColorDefaults