次の方法で共有

GetMonitorCapabilities 関数 (highlevelmonitorconfigurationapi.h)

  • [アーティクル]

警告

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

モニターの構成機能を取得します。 この関数を呼び出して、モニターでサポートされている高レベルのモニター構成関数を確認します。

構文

_BOOL GetMonitorCapabilities(
  [in]  HANDLE  hMonitor,
  [out] LPDWORD pdwMonitorCapabilities,
  [out] LPDWORD pdwSupportedColorTemperatures
);

パラメーター

[in] hMonitor

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

[out] pdwMonitorCapabilities

機能フラグのビットごとの OR を 受け取ります。 「解説」を参照してください。

[out] pdwSupportedColorTemperatures

色温度フラグのビットごとの OR を 受け取ります。 「解説」を参照してください。

戻り値

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

モニターが DDC/CI をサポートしていない場合、関数は失敗します。

注釈

pdwMonitorCapabilities で返される機能フラグは、モニターでサポートされる高レベルのモニター構成関数を指定します。 また、特定の関数の動作を指定します。 次の機能フラグが定義されています。

値 説明
MC_CAPS_BRIGHTNESS このモニターは 、GetMonitorBrightness 関数と SetMonitorBrightness 関数をサポートしています。
MC_CAPS_COLOR_TEMPERATURE このモニターでは、 GetMonitorColorTemperature 関数と SetMonitorColorTemperature 関数がサポートされています。
MC_CAPS_CONTRAST このモニターでは、 GetMonitorContrast 関数と SetMonitorContrast 関数が サポートされています。
MC_CAPS_DEGAUSS モニターは DegaussMonitor 関数を サポートしています。
MC_CAPS_DISPLAY_AREA_POSITION このモニターは 、GetMonitorDisplayAreaPosition 関数と SetMonitorDisplayAreaPosition 関数を サポートしています。
MC_CAPS_DISPLAY_AREA_SIZE モニターでは 、GetMonitorDisplayAreaSize 関数と SetMonitorDisplayAreaSize 関数がサポートされています 。
MC_CAPS_MONITOR_TECHNOLOGY_TYPE このモニターでは 、GetMonitorTechnologyType 関数がサポートされています。
MC_CAPS_NONE モニターは、モニター設定をサポートしていません。
MC_CAPS_RED_GREEN_BLUE_DRIVE このモニターは 、GetMonitorRedGreenOrBlueDrive および SetMonitorRedGreenOrBlueDrive 関数を サポートしています。
MC_CAPS_RED_GREEN_BLUE_GAIN このモニターでは、 GetMonitorRedGreenOrBlueGain 関数と SetMonitorRedGreenOrBlueGain 関数がサポートされています 。
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS モニターは RestoreMonitorFactoryColorDefaults 関数をサポートしています 。
MC_CAPS_RESTORE_FACTORY_DEFAULTS モニターは RestoreMonitorFactoryDefaults 関数をサポートしています 。
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS このフラグが存在する場合、 RestoreMonitorFactoryDefaults 関数を呼び出すと、高レベルのモニター構成関数で使用されるすべてのモニター設定が有効になります。 詳細については、「 RestoreMonitorFactoryDefaults」の「解説」セクションを参照してください。
 

pdwSupportedColorTemperatures で返される色温度フラグは、モニターでサポートされる色温度を指定します。 次の色温度フラグが定義されています。

値 説明
MC_SUPPORTED_COLOR_TEMPERATURE_NONE 色温度はサポートされていません。
MC_SUPPORTED_COLOR_TEMPERATURE_4000K モニターは4,000ケルビン(K)色温度をサポートしています。
MC_SUPPORTED_COLOR_TEMPERATURE_5000K モニターは5,000のK色温度を支える。
MC_SUPPORTED_COLOR_TEMPERATURE_6500K モニターは6,500のK色温度を支える。
MC_SUPPORTED_COLOR_TEMPERATURE_7500K モニターは7,500 K色の温度を支える。
MC_SUPPORTED_COLOR_TEMPERATURE_8200K モニターは8,200 K色温度をサポートしています。
MC_SUPPORTED_COLOR_TEMPERATURE_9300K モニターは9,300 K色温度をサポートしています。
MC_SUPPORTED_COLOR_TEMPERATURE_10000K モニターは10,000のK色温度を支える。
MC_SUPPORTED_COLOR_TEMPERATURE_11500K モニターは11,500のK色温度を支える。

要件

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

こちらもご覧ください

構成関数の監視