PoFxRegisterPluginEx 函式 (pep_x.h)

  • 發行項

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

語法

NTSTATUS PoFxRegisterPluginEx(
  [in]      PPEP_INFORMATION        PepInformation,
  [in]      ULONGLONG               Flags,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

參數

[in] PepInformation

PEP_INFORMATION 結構的指標，其中包含 PEP 所實作之一或多個回呼例程的指標。 這些例程會處理由PoFx傳送至 PEP 的通知。

[in] Flags

用來設定 PEP 介面的一組旗標位。 將此成員設定為零或下列值。

旗標位 Description
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

PEP_KERNEL_INFORMATION 結構的指標。

傳回值

如果呼叫成功註冊 PEP，PoFxRegisterPluginEx 會傳回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 必須受到服務，操作系統必須重新啟動。

PoFxRegisterPlugin 例程類似於 PoFxRegisterPluginEx，不同之處在於它不會採用 Flags 參數。

PEP 必須在 IRQL = PASSIVE_LEVEL呼叫 PoFxRegisterPluginEx 。

規格需求

需求 值
最低支援的用戶端 從 Windows 10 開始提供。
目標平台 Windows
標頭 pep_x.h (包含 Pep_x.h)
程式庫 Ntoskrnl.lib
IRQL PASSIVE_LEVEL

另請參閱

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin