RestoreMonitorFactoryDefaults 函式 (highlevelmonitorconfigurationapi.h)
警告
實體監視器組態函式使用 VESA 監視器控制命令集 (MCCS) I2C 介面的標準。 許多監視器未完全實作該標準;因此,使用這些命令可能會導致未定義的監視行為。 不建議將這些函式用於任意監視器,而不需實際驗證它們如預期般運作。
將監視器的設定還原為其原廠預設值。
語法
_BOOL RestoreMonitorFactoryDefaults(
[in] HANDLE hMonitor
);
參數
[in] hMonitor
實體監視器的控制碼。 若要取得監視控制碼,請呼叫 GetPhysicalMonitorsFromHMONITOR 或 GetPhysicalMonitorsFromIDirect3DDevice9。
傳回值
如果函式成功,則傳回值為 TRUE。 如果函式失敗,傳回值為 FALSE。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
此函式會還原高階監視器組態函式支援的所有設定。 它也可以還原僅透過低階函式提供的設定,而且高階函式不支援。 每個設定的目前值都會變更為其 Factory 預設值。 變更的確切設定和這些設定的預設值取決於製造商。 此函式也可以變更某些設定所支援值的範圍。
如果支援此函式, GetMonitorCapabilities 函式會傳回MC_CAPS_RESTORE_FACTORY_DEFAULTS旗標。
此函式需要大約 5 秒的時間才能傳回。
如果 GetMonitorCapabilities 傳回MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS旗標,此函式也會啟用高階函式支援的所有監視設定。 有時候,應用程式可以藉由呼叫低階函式來停用特定設定。 使用者也可以藉由調整監視實體控制台上的設定來停用特定設定。 如果發生這種情況,則只能透過控制台或呼叫 RestoreMonitorFactoryDefaults重新啟用設定。 您無法使用高階函式來停用任何設定。
需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | highlevelmonitorconfigurationapi.h |
程式庫 | Dxva2.lib |
Dll | Dxva2.dll |