POFXCALLBACKUPDATEPLATFORMIDLESTATE コールバック関数 (pepfx.h)

  • [アーティクル]

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

構文

POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;

NTSTATUS Pofxcallbackupdateplatformidlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG PlatformState,
  [in] PPEP_PLATFORM_IDLE_STATE_UPDATE Update
)
{...}

パラメーター

[in] ProcessorHandle

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

[in] PlatformState

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

[in] Update

プラットフォームのアイドル 状態の更新 されたプロパティを含むPEP_PLATFORM_IDLE_STATE_UPDATE構造体へのポインター。

戻り値

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

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

注釈

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

PEP は、UpdatePlatformIdleState ルーチンを呼び出すために、すべてのPEP_NOTIFY_PPM_QUERY_PLATFORM_STATE通知が完了するまで待機する必要があります。

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

要件

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

こちらもご覧ください

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE