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 |