PEPCALLBACKNOTIFYDPM 回调函数 (pepfx.h)
AcceptDeviceNotification 事件回调例程处理来自 Windows 电源管理框架(PoFx)的设备电源管理(DPM)通知。
语法
PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;
BOOLEAN Pepcallbacknotifydpm(
[in] ULONG Notification,
[in, out, optional] PVOID Data
)
{...}
参数
[in] Notification
DPM 通知 ID。 此参数指定 PoFx 正在发送的 DPM 通知的类型。 有关 DPM 通知 ID 的列表,请参阅 设备电源管理(DPM)通知。
[in, out, optional] Data
指向 PoFx 分配的结构的指针,该结构包含此通知的输入和输出数据。 此结构的类型取决于 通知指定的通知 ID。 有关为各种 DPM 通知 ID 定义的结构类型的列表,请参阅 设备电源管理(DPM)通知。
返回值
AcceptDeviceNotification 例程在处理通知时必须返回 TRUE;否则返回 FALSE。
言论
此例程由设备的平台扩展插件(PEP)实现。 PEP_INFORMATION 结构 成员的 AcceptDeviceNotification 是指向 AcceptDeviceNotification 例程的指针。 PEP 调用 PoFxRegisterPlugin 或 PoFxRegisterPluginEx 例程,以向 PoFx 注册 PEP 的 AcceptDeviceNotification 例程。
PoFx 调用此例程,将 DPM 通知发送到 PEP。 在此调用中,Notification 参数指定通知的类型,Data 参数指向与此通知关联的类型的数据结构。 有关 DPM 通知 ID 及其关联结构类型的列表,请参阅 设备电源管理(DPM)通知。
DPM 通知通知 PEP 各种系统、设备或组件级事件,或将请求从设备驱动程序传递到 PEP。
AcceptDeviceNotification 例程不必接受来自设备驱动程序的每个请求,例如,它可以忽略空闲驻留提示。 但是,PEP 必须了解并接受大多数设备电源管理通知,即使 PEP 选择不对其执行作也是如此。 PEP 必须拒绝处理(通过返回 FALSE)它无法识别的每个通知。
可以在 IRQL <= DISPATCH_LEVEL 调用 AcceptDeviceNotification 例程。 调用 PEP AcceptAcpiNotification 例程的 IRQL 因发送的通知类型而异。 通知类型由 Notification 参数指定。 有关详细信息,请参阅 设备电源管理(DPM)通知下的各个参考页。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 从 Windows 10 开始支持。 |
目标平台 | 窗户 |
标头 | pepfx.h (include Pep_x.h) |
IRQL | <= DISPATCH_LEVEL |