DXGK_BRIGHTNESS_GET回调函数 (dispmprt.h)

DxgkDdiGetBrightness 函数检索集成显示面板的当前活动亮度级别。

语法

DXGK_BRIGHTNESS_GET DxgkBrightnessGet;

NTSTATUS DxgkBrightnessGet(
  [in] PVOID Context,
  [in] PUCHAR Brightness
)
{...}

[in] Context

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

[in] Brightness

指向接收亮度级别的变量的指针。

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

当监视器驱动程序初始化时，它可以调用显示微型端口驱动程序的 DxgkDdiGetBrightness 函数，以检索集成显示面板当前处于活动状态的亮度级别。

由于监视器驱动程序始终在启动或恢复时获取集成显示面板的亮度级别，并且亮度的所有更改都会通过监视器驱动程序进行，因此监视器驱动程序应始终缓存当前亮度级别。因此，当客户端查询当前亮度级别时，将从监视器驱动程序而不是从显示微型端口驱动程序查询该级别。

DxgkDdiGetBrightness 应可分页。