SetMonitorRedGreenOrBlueDrive 関数 (highlevelmonitorconfigurationapi.h)
警告
物理モニター構成機能は、I2C インターフェース上で 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 モニター構成関数の使用」を参照してください。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | highlevelmonitorconfigurationapi.h |
Library | Dxva2.lib |
[DLL] | Dxva2.dll |