PEPCALLBACKNOTIFYDPM 回调函数 (pep_x.h)

  • 项目

AcceptDeviceNotification 事件回调例程处理设备电源管理 (DPM) 来自 Windows 电源管理框架 (PoFx) 的通知。

语法

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 分配结构的指针，该结构包含此通知的输入和输出数据。 此结构的类型取决于 Notification 指定的 通知 ID。 有关为各种 DPM 通知 ID 定义的结构类型的列表，请参阅 设备电源管理 (DPM) 通知。

返回值

AcceptDeviceNotification 例程在处理通知时必须返回 TRUE，否则返回 FALSE。

注解

此例程由设备的平台扩展插件 (PEP) 实现。 PEP_INFORMATION 结构的 AcceptDeviceNotification 成员是指向 AcceptDeviceNotification 例程的指针。 PEP 调用 PoFxRegisterPlugin 或 PoFxRegisterPluginEx 例程，将 PEP 的 AcceptDeviceNotification 例程注册到 PoFx。

PoFx 调用此例程以向 PEP 发送 DPM 通知。 在此调用中， Notification 参数指定通知的类型， Data 参数指向与此通知关联的类型的数据结构。 有关 DPM 通知 ID 及其关联结构类型的列表，请参阅 设备电源管理 (DPM) 通知。

DPM 通知通知 PEP 有关各种系统、设备或组件级事件的信息，或将请求从设备驱动程序传递到 PEP。

AcceptDeviceNotification 例程不必接受来自设备驱动程序的每个请求，例如，它可以忽略空闲驻留提示。 但是，PEP 必须理解并接受大多数设备电源管理通知，即使 PEP 选择不处理它们。 PEP 必须拒绝处理 (，方法是) 它无法识别的每个通知返回 FALSE。

可以在 IRQL <= DISPATCH_LEVEL 调用 AcceptDeviceNotification 例程。 调用 PEP 的 AcceptAcpiNotification 例程的 IRQL 因发送的通知类型而异。 通知类型由 Notification 参数指定。 有关详细信息，请参阅 设备电源管理 (DPM) 通知下的各个参考页。

要求

要求 值
最低受支持的客户端 从 Windows 10 开始支持。
目标平台 Windows
标头 pep_x.h (包括 Pep_x.h)
IRQL <= DISPATCH_LEVEL

另请参阅

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx