コールバック関数DXGK_BRIGHTNESS_GET_POSSIBLE (dispmprt.h)
DxgkDdiGetPossibleBrightness 関数は、統合ディスプレイ パネルでサポートされている明るさレベルを取得します。
構文
DXGK_BRIGHTNESS_GET_POSSIBLE DxgkBrightnessGetPossible;
NTSTATUS DxgkBrightnessGetPossible(
[in] PVOID Context,
[in] ULONG BufferSize,
[out] PUCHAR LevelCount,
[out] PUCHAR BrightnessLevels
)
{...}
パラメーター
[in] Context
[入力]ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前は Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in] BufferSize
[入力] BrightnessLevels パラメーターで渡されるバッファーのサイズ (バイト単位)。
[out] LevelCount
[out] BrightnessLevels パラメーターが指すバッファーでドライバーが返す明るさレベルの数を受け取る変数へのポインター。
[out] BrightnessLevels
[入力/出力]統合ディスプレイ・パネルがサポートする明るさレベルを受け取るバッファーへのポインター。
戻り値
DxgkDdiGetPossibleBrightness は、成功した場合STATUS_SUCCESSを返します。 それ以外の場合は、 Ntstatus.h で定義されているエラー コードのいずれかを返します。
注釈
ディスプレイ ミニポート ドライバーは、 BrightnessLevels パラメーターが指すバッファー内の明るさレベルを次の順序で返す必要があります。
- 最初の明るさレベルの値は、コンピューターが AC 電源で動作するときに BIOS が使用する明るさレベルです。
- 2 番目の明るさレベルの値は、コンピューターが DC 電源で動作するときに BIOS が使用する明るさレベルです。
- 残りの明るさレベルの値は、ハードウェアでサポートされている明るさレベルです。
DxgkDdiGetPossibleBrightness をページング可能にする必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| 対象プラットフォーム | デスクトップ |
| Header | dispmprt.h (Dispmprt.h を含む) |
| IRQL | PASSIVE_LEVEL |