PoFxRegisterPlugin 函式 (pep_x.h)

PoFxRegisterPlugin 例程會向 Windows 電源管理架構 (PoFx) 註冊平台擴充功能外掛程式 (PEP) 。

語法

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 。