PoFxRegisterCoreDevice 関数 (pepfx.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
ヘッダー pepfx.h (Pep_x.h を含む)
Library Ntoskrnl.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

PO_FX_CORE_DEVICE

UNICODE_STRING