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 和更高版本的 Windows 操作系统中可用。
目标平台	桌面
标头	dispmprt.h (包括 Dispmprt.h)
IRQL	PASSIVE_LEVEL

另请参阅

DxgkDdiAddDevice