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 関数の呼び出しに応答してディスプレイ パネルでアダプティブ明るさを有効にした後、アダプティブ明るさを無効にすることはできません。

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

追加のディスプレイ デバイスをシステムに接続することは、統合されたディスプレイ パネルでアダプティブ明るさ制御を実行するドライバーの機能を損なわない必要があります。

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

必要条件

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

関連項目

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice の

DxgkDdiSetBrightnessState を する