DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION回呼函式 (dispmprt.h)
擷取套用至整合式顯示面板的目前退光層級。
語法
DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION DxgkBrightnessGetBacklightReduction;
NTSTATUS DxgkBrightnessGetBacklightReduction(
[in] PVOID Context,
[out] DXGK_BACKLIGHT_INFO *BacklightInfo
)
{...}
參數
[in] Context
與顯示配接器相關聯的 DxgkDdiAddDevice 內容區塊句柄。 顯示迷你埠驅動程式的函式先前已將此句柄提供給 DirectX 圖形核心子系統。
[out] BacklightInfo
類型 為 DXGK_BACKLIGHT_INFO 的值，可提供目前縮減的迴光絕對層級。
傳回值
如果成功 ， 則傳回STATUS_SUCCESS。 否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
備註
此函式主要用於偵錯和測試，以確保使用顯示面板的品質用戶體驗。 呼叫此函式時，顯示迷你埠驅動程序必須一律提供有關整合式顯示面板的精確資訊。
請注意，對於某些硬體而言，BacklightInfo-BacklightUsersetting> 或 BacklightInfo-BacklightEffective> 的值可能不會對應到 Windows 亮度等級為零的百分比。 因此，操作系統需要 BacklightUsersetting 和 BacklightEffective所提供的絕對亮度資訊。 如果硬體使用 0 到 255 的亮度等級，則必須將這些值乘以 256，才能正確地將它們對應到 BacklightUsersetting 和 BacklightEffective 的 0 到 65535 範圍。
此函式應該可分頁。
計算回光縮小比例
(BRR) 的倒光縮小比例會計算 (為 backlightUsersetting BacklightUsersetting - BacklightEffective) / BacklightUsersetting。操作系統假設，為了回應新的亮度等級要求，驅動程式會將 BacklightUsersetting / BacklightEffective = 1.0 / (1.0 - BRR) 因素提升圖元亮度。
例如，如果 BRR = 0.2，驅動程式通常會將亮度提升為 1.0 / (1.0 - BRR) = 1.25，因此任何亮度值高於 255 * (1.0 - BRR) = 204 的像素都會飽和。 使用驅動程式所提供的BacklightInfo-GammaRamp>值，操作系統可以更精確地估計特定影像的圖元亮度失真。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 最低支援的伺服器 | Windows Server 2012 |
| 目標平台 | 桌面 |
| 標頭 | dispmprt.h (包括 Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |