POFXCALLBACKUPDATEPLATFORMIDLESTATE コールバック関数 (pep_x.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を返します。 考えられるエラーの戻り値には、次の状態コードが含まれます。
| 戻り値 | 説明 |
|---|---|
|
PEP_PLATFORM_IDLE_STATE_UPDATE構造体のバージョン番号は、サポートされている値ではありません。 |
|
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 |
| ヘッダー | pep_x.h (Pep_x.h を含む) |
| IRQL | PASSIVE_LEVEL |
こちらもご覧ください
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE