RestoreMonitorFactoryColorDefaults 函式 (highlevelmonitorconfigurationapi.h)

警告

實體監視器組態函式使用 VESA 監視器控制命令集 (MCCS) I²C 介面的標準。許多監視器未完全實作該標準;因此，使用這些命令可能會導致未定義的監視行為。不建議將這些函式用於任意監視器，而不需實際驗證它們如預期般運作。

將監視器的色彩設定還原為其原廠預設值。

語法

_BOOL RestoreMonitorFactoryColorDefaults(
  [in] HANDLE hMonitor
);

[in] hMonitor

實體監視器的句柄。若要取得監視句柄，請呼叫 GetPhysicalMonitorsFromHMONITOR 或 GetPhysicalMonitorsFromIDirect3DDevice9。

如果函式成功，則傳回值為 TRUE。如果函式失敗，傳回值為 FALSE。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

此函式可能會變更監視器亮度、對比、色彩溫度、磁碟驅動器和增益的目前值。每個設定的目前值都會變更為其 Factory 預設值。默認設定取決於製造商。此函式也可以變更每個設定的支援值範圍。函式不會啟用任何已停用的監視設定。

如果支援此函式， GetMonitorCapabilities 函式會傳回MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS旗標。此函式需要大約5秒的時間才能傳回。

此函式可能會重設無法透過高階監視器組態函式存取的監視設定。是否發生這種情況取決於監視的特定模型。

下列設定不會受到此函式的影響：

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	highlevelmonitorconfigurationapi.h
程式庫	Dxva2.lib
Dll	Dxva2.dll