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) 。監視驅動程式會實作 WMI 亮度控件，以選取亮度等級，或將亮度等級還原為目前使用中 DPPE 原則所選取的層級。選取亮度等級的 WMI 方法會覆寫目前的 DPPE 原則層級，直到發生 DPPE 原則的任何變更為止。當 DPPE 原則變更時，會設定新的 DPPE 層級。
為了與 Windows 2000 顯示驅動程式模型相容，監視器驅動程式會實作 IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS 作為使用者模式用戶端控制亮度的替代方式。 IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS呼叫的處理方式與選取亮度等級的 WMI 亮度控件相同。
監視驅動程式會將來自進階設定和電源介面的亮度熱鍵通知解譯 (ACPI) 驅動程式，因為使用者要求變更目前的亮度等級。如同 WMI 和 IOCTL 使用者模式介面，熱鍵通知所觸發的亮度等級變更會覆寫目前的 DPPE 原則，並持續生效，直到 DPPE 原則要求再次設定亮度值為止。

DxgkDdiSetBrightness 應該設為可分頁。