DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION回调函数 (dispmprt.h)

  • 项目

由 Microsoft DirectX 图形内核子系统调用，以设置显示微型端口驱动程序用于控制集成显示面板亮度的优化级别。

语法

DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;

NTSTATUS DxgkBrightnessSetBacklightOptimization(
  [in] PVOID Context,
  [in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}

参数

[in] Context

与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序的 DxgkDdiAddDevice 函数之前向 DirectX 图形内核子系统提供了此句柄。

[in] OptimizationLevel

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL 类型的值，指示亮度控件的优化级别。

返回值

如果成功 ， 则返回STATUS_SUCCESS。 否则，它将返回 Ntstatus.h 中定义的错误代码之一。

注解

显示微型端口驱动程序可以根据屏幕上的当前内容动态更改集成显示面板的背光优化级别。

驱动程序必须响应来自操作系统的请求，以更改 OptimizationLevel 参数中的背光优化级别。 此类请求基于系统状态更改。

驱动程序在显示面板上启用自适应亮度以响应对 DxgkDdiSetBrightnessState 函数的调用后，它不得禁用自适应亮度。

当驱动程序从一个背光优化级别过渡到另一个背光优化级别时，它应在集成显示面板的亮度设置中进行逐步转换。 此类转换的一个重要示例是，当用户调整视频播放控件时，操作系统通过将 OptimizationLevel 的值从 DxgkBacklightOptimizationDynamic 重置为 DxgkBacklightOptimizationDesktop 进行响应。

将其他显示设备连接到系统不得损害驱动程序在集成显示面板上执行自适应亮度控制的能力。

此函数应可分页。

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 桌面
标头 dispmprt.h (包括 Dispmprt.h)
IRQL PASSIVE_LEVEL

另请参阅

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice

DxgkDdiSetBrightnessState