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 構造体へのポインター。

PoFxRegisterPlugin 、呼び出しによって PEP が正常に登録された場合に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 呼び出す必要があります。