DXGK_BRIGHTNESS_GET_POSSIBLE回调函数 (dispmprt.h)

DxgkDdiGetPossibleBrightness 函数检索集成显示面板支持的亮度级别。

语法

DXGK_BRIGHTNESS_GET_POSSIBLE DxgkBrightnessGetPossible;

NTSTATUS DxgkBrightnessGetPossible(
  [in]  PVOID Context,
  [in]  ULONG BufferSize,
  [out] PUCHAR LevelCount,
  [out] PUCHAR BrightnessLevels
)
{...}

参数

[in] Context

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

[in] BufferSize

[in] 在 BrightnessLevels 参数中传递的缓冲区的大小(以字节为单位)。

[out] LevelCount

[out]指向变量的指针,该变量接收驱动程序在 BrightnessLevels 参数指向的缓冲区中返回的亮度级别数。

[out] BrightnessLevels

[in/out]指向接收集成显示面板支持的亮度级别的缓冲区的指针。

返回值

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

注解

显示微型端口驱动程序应按以下顺序返回 BrightnessLevels 参数指向的缓冲区中的亮度级别:

  • 第一个亮度级别值是当计算机使用交流电源运行时 BIOS 使用的亮度级别。
  • 第二个亮度级别值是当计算机使用 DC 电源运行时 BIOS 使用的亮度级别。
  • 剩余的亮度级别值是硬件支持的亮度级别。
为了简化实现显示微型端口驱动程序的工作,操作系统为驱动程序提供了 BrightnessLevels 参数指向的缓冲区。

应使 DxgkDdiGetPossibleBrightness 可分页。

要求

要求
最低受支持的客户端 Windows Vista
目标平台 桌面
标头 dispmprt.h (包括 Dispmprt.h)
IRQL PASSIVE_LEVEL

另请参阅

DxgkDdiAddDevice