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

[in]與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式先前已將此句柄提供給 Microsoft DirectX 圖形核心子系統。

[in] BufferSize

[in] 在 BrightnessLevels 參數中傳遞之緩衝區的大小，以位元組為單位。

[out] LevelCount

[out]變數的指標，接收驅動程式在 BrightnessLevels 參數指向的緩衝區中傳回的亮度等級數目。

[out] BrightnessLevels

[in/out]緩衝區的指標，接收整合式顯示面板支援的亮度等級。

傳回值

如果成功，DxgkDdiGetPossibleBrightness 會傳回STATUS_SUCCESS。 否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。

備註

顯示迷你埠驅動程序應該會在緩衝區中傳回 BrightnessLevels 參數以下列順序指向的亮度等級：

• 第一個亮度等級值是 BIOS 在 AC 電源上執行時所使用的亮度等級。
• 第二個亮度等級值是 BIOS 在 DC 電源上執行時所使用的亮度等級。
• 其餘的亮度等級值是硬體支援的亮度等級。

為了簡化實作顯示迷你埠驅動程式的工作，操作系統會提供驅動程式 與 BrightnessLevels 參數所指向的緩衝區。

DxgkDdiGetPossibleBrightness 應該設為可分頁。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	dispmprt.h (包含 Dispmprt.h)
IRQL	PASSIVE_LEVEL

另請參閱

DxgkDdiAddDevice