IPowerNotify：:P owerChangeNotify 方法 (portcls.h)

  • 项目

方法 PowerChangeNotify 将电源状态更改通知微型端口驱动程序。

语法

void PowerChangeNotify(
  [in] POWER_STATE PowerState
);

参数

[in] PowerState

指定当前电源状态。 此参数是 POWER_STATE 类型的联合。 新的电源状态 (PowerState。DeviceState) 可以是 IAdapterPowerManagement：:P owerChangeState 中列出的DEVICE_POWER_STATE枚举值之一。

返回值

无

备注

PortCls 系统驱动程序调用微型端口驱动程序 PowerChangeNotify 的 方法，以通知其电源状态的更改。 此调用的目的是让微型端口驱动程序有机会在关机前保存任何特定于硬件的上下文，或者在开机后还原以前保存的上下文。

微型端口驱动程序可以在调用期间 PowerChangeNotify 写入硬件寄存器或板载内存。 如果系统关闭电源 (从 PowerDeviceD0) 进行状态转换，则 PortCls 系统驱动程序在 PowerChangeNotify 调用 IAdapterPowerManagement：:P owerChangeState 之前调用 ，并在暂停任何活动音频数据流后调用 。 这让微型端口驱动程序有机会在设备关闭之前保存任何特定于硬件的设备上下文。 例如，WavePci 微型端口驱动程序可能需要保存其 DMA 寄存器，如果在一系列散点/收集数据传输过程中发生关机。 如果系统正在启动 (进行状态转换到 PowerDeviceD0) ，则 PortCls 在调用 PowerChangeState 之后，并在重启任何暂停的音频数据流之前调用 PowerChangeNotify 。 这使微型端口驱动程序有机会在设备通电后还原以前保存的上下文。

此方法的代码必须驻留在分页内存中。

要求

要求 值
目标平台 通用
标头 portcls.h (包括 Portcls.h)

另请参阅

IAdapterPowerManagement：:P owerChangeState

IPowerNotify