共用方式為


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 應設為可分頁。

要求

要求 價值
最低支援的用戶端 Windows Vista
目標平臺 桌面
標頭 dispmprt.h (包括 Dispmprt.h)
IRQL PASSIVE_LEVEL

另請參閱

DxgkDdiAddDevice

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS