DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATIONコールバック関数 (dispmprt.h)

  • [アーティクル]

Microsoft DirectX グラフィックス カーネル サブシステムによって呼び出され、ディスプレイ ミニポート ドライバーが統合ディスプレイ パネルの明るさを制御するために使用する最適化のレベルを設定します。

構文

DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;

NTSTATUS DxgkBrightnessSetBacklightOptimization(
  [in] PVOID Context,
  [in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}

パラメーター

[in] Context

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前は DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。

[in] OptimizationLevel

輝度制御の最適化レベルを示す DXGK_BACKLIGHT_OPTIMIZATION_LEVEL 型の値。

戻り値

成功した場合は、STATUS_SUCCESSを返します。 それ以外の場合は、Ntstatus.h で定義されているエラー コードのいずれかを返します。

注釈

ディスプレイ ミニポート ドライバーは、画面上の現在のコンテンツに基づいて、統合ディスプレイ パネルのバックライト最適化レベルを動的に変更できます。

OptimizationLevel パラメーターでバックライトの最適化レベルを変更するには、ドライバーがオペレーティング システムからの要求に応答する必要があります。 このような要求は、システム状態の変更に基づいています。

DxgkDdiSetBrightnessState 関数の呼び出しに応じて、ドライバーがディスプレイ パネルでアダプティブ明るさを有効にした後、アダプティブ明るさを無効にすることはできません。

ドライバーがバックライト最適化レベルから別のバックライト最適化レベルに移行すると、統合ディスプレイ パネルの明るさ設定が段階的に切り替わります。 この種の遷移の重要な例は、ユーザーがビデオ再生コントロールを調整し、オペレーティング システムが OptimizationLevel の値を DxgkBacklightOptimizationDynamic から DxgkBacklightOptimizationDesktop にリセットして応答する場合です。

追加のディスプレイ デバイスをシステムに接続する場合、統合ディスプレイ パネルで適応型の明るさ制御を実行するドライバーの機能を損なってはなりません。

この関数はページング可能にする必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム デスクトップ
Header dispmprt.h (Dispmprt.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice

DxgkDdiSetBrightnessState