SetMonitorRedGreenOrBlueDrive 函式 (highlevelmonitorconfigurationapi.h)

  • 發行項

警告

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

設定監視器的紅色、綠色或藍色磁片磁碟機值。

語法

_BOOL SetMonitorRedGreenOrBlueDrive(
  [in] HANDLE        hMonitor,
  [in] MC_DRIVE_TYPE dtDriveType,
  [in] DWORD         dwNewDrive
);

參數

[in] hMonitor

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

[in] dtDriveType

MC_DRIVE_TYPE列舉的成員，指定是否要設定紅色、綠色或藍色磁片磁碟機值。

[in] dwNewDrive

紅色、綠色或藍色磁片磁碟機值。 若要取得監視器的最小和最大磁片磁碟機值，請呼叫 GetMonitorRedGreenOrBlueDrive。

傳回值

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

備註

磁片磁碟機設定通常用來調整監視器的白點。 磁片磁碟機 和 黑色層級 是相同監視設定的不同名稱。

如果支援此函式， GetMonitorCapabilities 函式會傳回MC_CAPS_RED_GREEN_BLUE_DRIVE旗標。

此函式需要大約 50 毫秒的時間才能傳回。

變更磁片磁碟機設定可能會變更色彩溫度。 若要取得新的色彩溫度，請呼叫 GetMonitorColorTemperature。

磁片磁碟機設定是連續監視設定。 如需詳細資訊，請參閱 使用 High-Level 監視組態函式。

需求

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

另請參閱

監視組態函式