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 - 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

另请参阅

DXGK_BACKLIGHT_INFO

DxgkDdiAddDevice