RestoreMonitorFactoryColorDefaults 関数 (highlevelmonitorconfigurationapi.h)
警告
物理モニター構成機能は、I2C インターフェース上で VESA モニター制御コマンド・セット (MCCS) 標準を使用して機能します。 多くのモニターでは、その標準が完全に実装されていません。そのため、これらのコマンドを使用すると、未定義のモニター動作が発生する可能性があります。 これらの関数は、意図したとおりに動作することを物理的に検証せずに、任意のモニターに使用することはお勧めしません。
モニターの色設定を工場出荷時の既定値に戻します。
構文
_BOOL RestoreMonitorFactoryColorDefaults(
[in] HANDLE hMonitor
);
パラメーター
[in] hMonitor
物理モニターへのハンドル。 モニター ハンドルを取得するには、 GetPhysicalMonitorsFromHMONITOR または GetPhysicalMonitorsFromIDirect3DDevice9 を呼び出します。
戻り値
関数が成功した場合、戻り値は TRUE になります。 関数が失敗した場合、戻り値は FALSE になります。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
この関数は、モニターの明るさ、コントラスト、色温度、ドライブ、ゲインの現在の値を変更する可能性があります。 各設定の現在の値は、出荷時の既定値に変更されます。 既定の設定は製造元によって異なります。 この関数は、これらの各設定でサポートされている値の範囲を変更することもできます。 この関数では、無効にされたモニター設定は有効になりません。
この関数がサポートされている場合、 GetMonitorCapabilities 関数は MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS フラグを返します。 この関数の戻り時間は約 5 秒です。
この関数は、高レベルのモニター構成機能を介してアクセスできないモニター設定をリセットする場合があります。 これが発生するかどうかは、モニターの特定のモデルによって異なります。
次の設定は、この関数の影響を受けません。
- 表示領域のサイズ
- 表示領域の位置
- 機能フラグ
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | highlevelmonitorconfigurationapi.h |
Library | Dxva2.lib |
[DLL] | Dxva2.dll |