PoFxRegisterPluginEx 関数 (pepfx.h)

  • [アーティクル]

PoFxRegisterPluginEx ルーチンは、プラットフォーム拡張機能プラグイン (PEP) を Windows 電源管理フレームワーク (PoFx) に登録します。

構文

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

パラメーター

[in] PepInformation

PEP によって実装される 1 つ以上のコールバック ルーチンへのポインターを含む PEP_INFORMATION構造体への ポインター。 これらのルーチンは、PoFx によって PEP に送信される通知を処理します。

[in] Flags

PEP インターフェイスを構成するためのフラグ ビットのセット。 このメンバーを 0 または次の値に設定します。

フラグ ビット 説明
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 は登録を解除できず、2 回登録することもできません。 PEP をサービスする必要がある場合は、オペレーティング システムを再起動する必要があります。

PoFxRegisterPlugin ルーチンは、Flags パラメーターを受け取らない点を除き、PoFxRegisterPluginEx に似ています。

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

要件

要件 値
サポートされている最小のクライアント Windows 10 以降で使用できます。
対象プラットフォーム Windows
ヘッダー pepfx.h (Pep_x.h を含む)
Library Ntoskrnl.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin