PoFxRegisterPlugin 関数 (pepfx.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_KERNEL_INFORMATION_STRUCT_V3構造体へのポインター。

呼び出しによって 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 は登録を解除できず、2 回登録することはできません。 PEP を処理する必要がある場合は、オペレーティングシステムを再起動する必要があります。

PoFxRegisterPluginEx ルーチンは、追加のパラメーター Flags を受け取る点を除き、PoFxRegisterPlugin と似ています。

PEP は、IRQL = PASSIVE_LEVELで PoFxRegisterPlugin を呼び出す必要があります。