DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION回呼函式 (dispmprt.h)
由 Microsoft DirectX 圖形核心子系統呼叫，以設定顯示迷你埠驅動程式用來控制整合式顯示面板亮度的優化層級。
語法
DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;
NTSTATUS DxgkBrightnessSetBacklightOptimization(
[in] PVOID Context,
[in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}
參數
[in] Context
與顯示配接器相關聯的內容區塊句柄。 顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式先前已將此句柄提供給 DirectX 圖形核心子系統。
[in] OptimizationLevel
型 別為 DXGK_BACKLIGHT_OPTIMIZATION_LEVEL 的值，表示亮度控件的優化等級。
傳回值
如果成功，則會 傳回STATUS_SUCCESS 。 否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
備註
顯示迷你埠驅動程式可以根據螢幕上目前的內容，動態變更整合式顯示面板的反光優化層級。
驅動程式必須回應操作系統的要求，才能變更 OptimizationLevel 參數中的反光優化層級。 這類要求是以系統狀態變更為基礎。
驅動程式在顯示面板上啟用調適型亮度以回應 對 DxgkDdiSetBrightnessState 函式的呼叫之後，它不得停用調適型亮度。
當驅動程式從一個反光優化層級轉換到另一個後光優化層級時，它應該會在整合式顯示面板的亮度設定中逐漸轉換。 這種轉換類型的重要範例是當使用者將 OptimizationLevel 的值從 DxgkBacklightOptimizationDynamic 重設為 DxgkBacklightOptimizationDesktop 來調整視訊播放控件和操作系統回應時。
將其他顯示器裝置連接到系統，不得危害驅動程式在整合式顯示器面板上執行調適型亮度控制的能力。
此函式應該可分頁。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 最低支援的伺服器 | Windows Server 2012 |
| 目標平台 | 桌面 |
| 標頭 | dispmprt.h (包含 Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |