PoFxRegisterPlugin 函数 (pep_x.h)

PoFxRegisterPlugin 例程将平台扩展插件 (PEP) 注册到 Windows 电源管理框架 (PoFx) 。

语法

NTSTATUS PoFxRegisterPlugin(
  [in]      PPEP_INFORMATION        PepInformation,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

[in] PepInformation

指向 PEP_INFORMATION 结构的指针。

[in, out] KernelInformation

如果调用成功注册 PEP，PoFxRegisterPlugin 将返回STATUS_SUCCESS。可能的错误返回值包括以下状态代码。

返回值	说明
STATUS_INVALID_PARAMETER	PEP_KERNEL_INFORMATION 结构的 Version 或 Size 成员设置为无效值;或此结构的 AcceptDeviceNotification 成员设置为 NULL。
STATUS_INVALID_PEP_INFO_VERSION	PEP_INFORMATION 结构的 Version 成员设置为无效值。
STATUS_INSUFFICIENT_RESOURCES	无法分配完成请求的注册所需的资源。

PEP 调用此例程以将自身注册到 PoFx。

PEP 无法注销，也不能注册两次。如果必须维护 PEP，则必须重启操作系统。

PoFxRegisterPluginEx 例程类似于 PoFxRegisterPlugin，只不过它采用其他参数 Flags。

PEP 必须在 IRQL = PASSIVE_LEVEL 调用 PoFxRegisterPlugin 。