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 系统驱动程序在调用 IAdapterPowerManagement::P owerChangeState 并在暂停任何活动音频数据流后调用 PowerChangeNotify
。 这使微型端口驱动程序有机会在设备关闭之前保存任何特定于硬件的设备上下文。 例如,如果一系列散点/收集数据传输期间关闭电源,WavePci 微型端口驱动程序可能需要保存其 DMA 寄存器。 如果系统正在启动(向 PowerDeviceD0 进行状态转换),则 PortCls 会在调用 PowerChangeState 并在重启任何暂停的音频数据流之前调用 PowerChangeNotify
。 这使微型端口驱动程序有机会在设备启动后还原以前保存的上下文。
此方法的代码必须驻留在分页内存中。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
标头 | portcls.h (包括 Portcls.h) |