GetMonitorRedGreenOrBlueDrive 関数 (highlevelmonitorconfigurationapi.h)

  • [アーティクル]

警告

物理モニター構成機能は、I2C インターフェース上で VESA モニター制御コマンド・セット (MCCS) 標準を使用して機能します。 多くのモニターでは、その標準が完全に実装されていません。そのため、これらのコマンドを使用すると、未定義のモニター動作が発生する可能性があります。 これらの関数は、意図したとおりに動作することを物理的に検証せずに、任意のモニターに使用することはお勧めしません。

モニターの赤、緑、または青のドライブ値を取得します。

構文

_BOOL GetMonitorRedGreenOrBlueDrive(
  [in]  HANDLE        hMonitor,
  [in]  MC_DRIVE_TYPE dtDriveType,
  [out] LPDWORD       pdwMinimumDrive,
  [out] LPDWORD       pdwCurrentDrive,
  [out] LPDWORD       pdwMaximumDrive
);

パラメーター

[in] hMonitor

物理モニターへのハンドル。 モニター ハンドルを取得するには、 GetPhysicalMonitorsFromHMONITOR または GetPhysicalMonitorsFromIDirect3DDevice9 を呼び出します。

[in] dtDriveType

MC_DRIVE_TYPE 列挙体 のメンバー。赤、緑、青のドライブ値を取得するかどうかを指定します。

[out] pdwMinimumDrive

赤、緑、または青のドライブの最小値を受け取ります。

[out] pdwCurrentDrive

現在の赤、緑、または青のドライブ値を受け取ります。

[out] pdwMaximumDrive

最大の赤、緑、または青のドライブ値を受け取ります。

戻り値

関数が成功した場合、戻り値は TRUE になります。 関数が失敗した場合、戻り値は FALSE になります。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

ドライブの設定は、一般にモニターのホワイト ポイントを調整するために使用されます。 ドライブ レベルと ブラックレベル は、同じモニター設定に対して異なる名前です。 この関数がサポートされている場合、 GetMonitorCapabilities 関数は MC_CAPS_RED_GREEN_BLUE_DRIVE フラグを返します。

この関数の戻り時間は約 40 ミリ秒です。

ドライブの設定は、継続的なモニター設定です。 詳細については、「 High-Level モニター構成関数の使用」を参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー highlevelmonitorconfigurationapi.h
Library Dxva2.lib
[DLL] Dxva2.dll

関連項目

構成関数の監視