DXGK_BRIGHTNESS_SET コールバック関数 (dispmprt.h)
DxgkDdiSetBrightness 関数は、新しい明るさレベルを設定します。
構文
DXGK_BRIGHTNESS_SET DxgkBrightnessSet;
NTSTATUS DxgkBrightnessSet(
[in] PVOID Context,
[in] UCHAR Brightness
)
{...}
パラメーター
[in] Context
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前は Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in] Brightness
設定する明るさレベルの値。
戻り値
DxgkDdiSetBrightness は、新しい明るさレベルの設定に成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、 Ntstatus.h で定義されているエラー コードのいずれかを返します。
注釈
モニター ドライバーは、次の理由から、ディスプレイ ミニポート ドライバーの DxgkDdiSetBrightness 関数を呼び出して、統合ディスプレイ パネルの明るさレベルを変更します。
- デバイス電源ポリシー エンジン (DPPE) からの通知は、現在のポリシーが変更されているか、新しいポリシーが有効になっていることを示します。 新しい DPPE ポリシーは、システムの起動、再開、およびユーザー スイッチ、および電源が変更されたときに有効になります。
- ユーザー モード クライアントが明るさを制御する推奨される方法は、Windows Management Instrumentation (WMI) を使用することです。 モニター ドライバーは、明るさレベルを選択するか、明るさレベルを現在アクティブな DPPE ポリシーによって選択されたレベルに戻す WMI の明るさコントロールを実装します。 明るさレベルを選択する WMI メソッドは、DPPE ポリシーの変更が発生するまで、現在の DPPE ポリシー レベルをオーバーライドします。 DPPE ポリシーが変更されると、新しい DPPE レベルが設定されます。
- Windows 2000 ディスプレイ ドライバー モデルとの互換性のために、モニター ドライバーは、ユーザー モード クライアントが明るさを制御する別の方法としてIOCTL_VIDEO_SET_DISPLAY_BRIGHTNESSを実装します。 IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESSの呼び出しは、明るさレベルを選択する WMI 輝度コントロールと同じ方法で処理されます。
- モニター ドライバーは、Advanced Configuration および Power Interface (ACPI) ドライバーからの明るさホット キー通知を、現在の明るさレベルを変更するユーザー要求として解釈します。 WMI および IOCTL ユーザー モード インターフェイスと同様に、ホット キー通知によってトリガーされる明るさレベルの変更は、現在の DPPE ポリシーをオーバーライドし、DPPE ポリシーが明るさの値を再び設定するように要求するまで有効なままです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | dispmprt.h (Dispmprt.h を含む) |
| IRQL | PASSIVE_LEVEL |