SetMonitorColorTemperature 函式 (highlevelmonitorconfigurationapi.h)

警告

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

設定監視器的色彩溫度。

語法

_BOOL SetMonitorColorTemperature(
  [in] HANDLE               hMonitor,
  [in] MC_COLOR_TEMPERATURE ctCurrentColorTemperature
);

參數

[in] hMonitor

實體監視器的控制碼。 若要取得監視控制碼，請呼叫 GetPhysicalMonitorsFromHMONITOR 或 GetPhysicalMonitorsFromIDirect3DDevice9。

[in] ctCurrentColorTemperature

指定為 MC_COLOR_TEMPERATURE 列舉成員的色彩溫度。

傳回值

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

備註

如果支援此函式， GetMonitorCapabilities 函式會傳回MC_CAPS_COLOR_TEMPERATURE旗標。 GetMonitorCapabilities 函式也會傳回監視器支援的色彩溫度範圍。 ctCurrentColorTemperature參數必須對應至其中一個值。

變更色彩溫度會變更監視器的白色點。 它也可以變更目前的磁片磁碟機並取得設定。 若要取得新的磁片磁碟機並取得設定，請分別呼叫 GetMonitorRedGreenOrBlueDrive 和 GetMonitorRedGreenOrBlueGain。

此函式需要 50 到 90 毫秒才能傳回。

需求

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

另請參閱

監視組態函式