PVIDEO_HW_POWER_GET回调函数 (video.h)

  • 项目

HwVidGetPowerState 查询设备是否可以支持请求的电源状态。

语法

PVIDEO_HW_POWER_GET PvideoHwPowerGet;

VP_STATUS PvideoHwPowerGet(
  PVOID HwDeviceExtension,
  ULONG HwId,
  PVIDEO_POWER_MANAGEMENT VideoPowerControl
)
{...}

参数

HwDeviceExtension

指向微型端口驱动程序的每个适配器存储区域的指针。 有关详细信息，请参阅 设备扩展。

HwId

指向 32 位 设备 ID 的指针，该 ID 唯一标识微型端口驱动程序应查询的设备。 此参数由微型端口驱动程序的 HwVidGetVideoChildDescriptor 函数返回。 或者，值为 DISPLAY_ADAPTER_HW_ID 表示正在请求适配器本身的电源信息。

VideoPowerControl

指向 VIDEO_POWER_MANAGEMENT 结构的指针，该结构指定要查询其支持的电源状态。

返回值

HwVidGetPowerState 返回以下值之一：

返回代码 说明
NO_ERROR 设备支持请求的电源状态。
ERROR_DEVICE_REINITIALIZATION_NEEDED 驱动程序未通过电源状态查询。

注解

HwVidGetPowerState 是视频微型端口驱动程序中的必需函数。

驱动程序应检查 HwId 中指定的 ID，以确定要查询的设备。 然后，驱动程序应确定该设备是否支持 VideoPowerControl 指向的VIDEO_POWER_MANAGEMENT结构的 PowerState 成员中指定的电源状态。

此函数不得返回设备的当前电源状态。

应使 HwVidGetPowerState 可分页。

要求

要求 值
目标平台 桌面
标头 video.h (包括 Video.h)

另请参阅

HwVidGetVideoChildDescriptor

HwVidSetPowerState

VIDEO_POWER_MANAGEMENT