DXGK_BRIGHTNESS_GET回呼函式 (dispmprt.h)

DxgkDdiGetBrightness 函式會擷取整合式顯示面板目前作用中的亮度等級。

語法

DXGK_BRIGHTNESS_GET DxgkBrightnessGet;

NTSTATUS DxgkBrightnessGet(
  [in] PVOID Context,
  [in] PUCHAR Brightness
)
{...}

[in] Context

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

[in] Brightness

接收亮度等級之變數的指標。

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

當監視驅動程式初始化時，它可以呼叫 display miniport 驅動程式的 DxgkDdiGetBrightness 函式，以擷取目前對整合式顯示面板作用中的亮度等級。

由於監視器驅動程式一律會在開機或繼續時取得整合式顯示面板的亮度等級，且亮度的所有變更都會通過監視驅動程式，因此監視驅動程序應該一律快取目前的亮度等級。因此，當客戶端查詢目前亮度等級時，會從監視驅動程序查詢層級，而不是從顯示迷你埠驅動程序查詢層級。

DxgkDdiGetBrightness 應該設為可分頁。