SetMonitorRedGreenOrBlueDrive 函数 (highlevelmonitorconfigurationapi.h)

警告

物理监视器配置功能通过 I²C 接口使用 VESA 监视器控制命令集 (MCCS) 标准。许多监视器未完全实现该标准;因此，使用这些命令可能会导致未定义的监视器行为。在未对任意监视器进行物理验证的情况下，不建议将这些函数用于任意监视器，因为它们是否按预期工作。

设置监视器的红色、绿色或蓝色驱动器值。

语法

_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 Monitor 配置函数。


最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	highlevelmonitorconfigurationapi.h
Library	Dxva2.lib
DLL	Dxva2.dll