コールバック関数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 が使用する明るさレベルです。
• 残りの明るさレベルの値は、ハードウェアでサポートされている明るさレベルです。

ディスプレイ ミニポート ドライバーを実装するジョブを簡略化するために、オペレーティング システムはドライバーに BrightnessLevels パラメーターが指すバッファーを提供します。

DxgkDdiGetPossibleBrightness をページング可能にする必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム	デスクトップ
Header	dispmprt.h (Dispmprt.h を含む)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

DxgkDdiAddDevice