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) |