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 範圍。

此函式應該可分頁。

計算回光縮小比例

操作系統假設，為了回應新的亮度等級要求，驅動程式會將 BacklightUsersetting / BacklightEffective = 1.0 / (1.0 - BRR) 因素提升圖元亮度。

例如，如果 BRR = 0.2，驅動程式通常會將亮度提升為 1.0 / (1.0 - BRR) = 1.25，因此任何亮度值高於 255 * (1.0 - BRR) = 204 的像素都會飽和。 使用驅動程式所提供的BacklightInfo-GammaRamp>值，操作系統可以更精確地估計特定影像的圖元亮度失真。

規格需求

另請參閱

DXGK_BACKLIGHT_INFO

DxgkDdiAddDevice