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 を使用したコア システム リソースの登録を表します。

戻り値

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

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

備考

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

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

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 10 以降で使用できます。
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	pep_x.h (Pep_x.h を含む)
ライブラリ	Ntoskrnl.lib
IRQL	PASSIVE_LEVEL

関連項目

PO_FX_CORE_DEVICE

UNICODE_STRING