PoFxRegisterCoreDevice 関数 (pep_x.h)

  • [アーティクル]

PoFxRegisterCoreDevice ルーチンは、新しいコア システム リソースを Windows 電源管理フレームワーク (PoFx) に登録します。

構文

NTSTATUS PoFxRegisterCoreDevice(
  [in]  PCUNICODE_STRING   Id,
  [in]  PPO_FX_CORE_DEVICE Device,
  [out] POHANDLE           *Handle
);

パラメーター

[in] Id

コア システム リソースを一意に識別する文字列。 このメンバーは、デバイス識別文字列を含むUNICODE_STRING構造体へのポインターです。

[in] Device

コア システム リソースの電源特性を記述する PO_FX_CORE_DEVICE 構造体へのポインター。

[out] Handle

ルーチンが POHANDLE 値を書き込む場所へのポインター。 このハンドルは、PoFx を使用したコア システム リソースの登録を表します。

戻り値

呼び出しで PEP が正常に登録された場合、PoFxRegisterCoreDevice はSTATUS_SUCCESSを返します。 考えられるエラーの戻り値には、次の状態コードが含まれます。

戻り値 説明
STATUS_INVALID_PARAMETER
 このデバイスのコンポーネント数が 0 であるか、 PO_FX_CORE_DEVICE 構造体に無効なバージョン番号が含まれているか、この構造体の ComponentCriticalTransitionCallback メンバーに無効な関数ポインターが含まれています。
STATUS_INSUFFICIENT_RESOURCES
 要求された登録を完了するために必要なリソースを割り当てられません。

注釈

このルーチンは、PoFx でこのリソースを電源管理できるように、コア システム リソースを登録します。

コア システム リソースは、Windows ハードウェア抽象化レイヤー (HAL) によって管理されるハードウェア デバイス (タイマーや割り込みコントローラーなど) です。 これらのデバイスは、オペレーティング システムに必要な基本的な機能を提供します。 コア システム リソースとプロセッサの間に密接な関係があるため、これらのリソースの電源管理はプロセッサのアイドル状態管理と調整する必要があります。

PoFxRegisterCoreDevice ルーチンは IRQL = PASSIVE_LEVEL で呼び出す必要があります。

要件

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

こちらもご覧ください

PO_FX_CORE_DEVICE

UNICODE_STRING