POFXCALLBACKUPDATEPROCESSORIDLESTATE コールバック関数 (pep_x.h)

  • [アーティクル]

UpdateProcessorIdleState ルーチンは、指定されたプロセッサアイドル状態のプロパティを更新するために、プラットフォーム拡張機能プラグイン (PEP) によって呼び出されます。

構文

POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;

NTSTATUS Pofxcallbackupdateprocessoridlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] PPEP_PROCESSOR_IDLE_STATE_UPDATE Update
)
{...}

パラメーター

[in] ProcessorHandle

Windows 電源管理フレームワーク (PoFx) にプロセッサ (デバイスとして) の登録を表す POHANDLE 値。 PEP は、プロセッサが PoFx に登録されたことを PEP に通知した PEP_DPM_REGISTER_DEVICE 通知中に、以前に PoFx からこのハンドルを受け取っていました。

[in] ProcessorState

プロパティを更新するプロセッサのアイドル状態を識別するインデックス。 以前の PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 通知に応答して、PEP はサポートされているプロセッサアイドル状態の数とこれらの状態のプロパティを指定しました。 PEP で N 個のプロセッサアイドル状態が指定されている場合、有効なプロセッサ アイドル状態インデックスの範囲は 0 から N-1 です。

[in] Update

プロセッサのアイドル状態の更新されたプロパティを含む PEP_PROCESSOR_IDLE_STATE_UPDATE 構造体へのポインター。

戻り値

UpdateProcessorIdleState は、プロセッサのアイドル状態のプロパティを正常に更新した場合、STATUS_SUCCESSを返します。 エラーの戻り値として考えられるのは、次の状態コードです。

戻り値 説明
STATUS_NOT_SUPPORTED
 PEP_PROCESSOR_IDLE_STATE_UPDATE 構造体のバージョン番号は、サポートされている値ではありません。
STATUS_NOT_IMPLEMENTED
 UpdateProcessorIdleState ルーチンは、このプロセッサには実装されていません。

注釈

このルーチンは PoFx によって実装され、PEP によって呼び出されます。 PEP_KERNEL_INFORMATION_STRUCT_V3構造体の UpdateProcessorIdleState メンバーは、UpdateProcessorIdleState ルーチンへのポインターです。

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

要件

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

こちらもご覧ください

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE