次の方法で共有


GetMonitorCapabilities 関数 (highlevelmonitorconfigurationapi.h)

Warnung

物理モニター構成機能は、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 [デスクトップ アプリのみ]
ターゲット プラットフォーム ウィンドウズ
ヘッダー highlevelmonitorconfigurationapi.h
図書館 Dxva2.lib
DLL Dxva2.dll

こちらも参照ください

Monitor 構成関数の