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 以降でサポートされています。 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | pep_x.h (Pep_x.h を含む) |
| IRQL | PASSIVE_LEVEL |
関連項目
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE