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

ProcessorHalt ルーチンは、プロセッサを停止する準備をします。

構文

POFXCALLBACKPROCESSORHALT Pofxcallbackprocessorhalt;

NTSTATUS Pofxcallbackprocessorhalt(
  [in]                ULONG Flags,
  [in, out, optional] PVOID Context,
  [in]                PPROCESSOR_HALT_ROUTINE Halt
)
{...}

パラメーター

[in] Flags

プロセッサが入力するアイドル状態のプロパティを示すフラグ。 Flags パラメーターは、次の 1 つ以上のフラグ ビットの 0 またはビットごとの OR に設定されます。

[in, out, optional] Context

PEP で定義されたプロセッサ停止コンテキストへのポインター。 このポインターは、 停止 コールバック ルーチンにパラメーターとして渡されます。 このコンテキストは、Windows 電源管理フレームワーク (PoFx) に対して不透明です。

[in] Halt

PEP で実装された Halt コールバック ルーチンへのポインター。 PoFx は、プロセッサを停止する準備が完了した後、このルーチンを呼び出します。 このコールバック中に、PEP はプロセッサを 停止状態 に切り替える必要があります。

戻り値

ProcessorHalt は、プロセッサが正常に停止する準備ができた場合にSTATUS_SUCCESSを返します。 考えられるエラーの戻り値には、次の状態コードが含まれます。

注釈

このルーチンは、電源管理フレームワーク (PoFx) によって実装され、プラットフォーム拡張機能プラグイン (PEP) によって呼び出されます。 PEP_KERNEL_INFORMATION_STRUCT_V3構造体の ProcessorHalt メンバーは、ProcessorHalt ルーチンへのポインターです。

プロセッサを停止する前に、PEP は ProcessorHalt ルーチンを呼び出して、PoFx にプロセッサのハードウェア コンテキストを保存する機会を与えます。 必要に応じて、 ProcessorHalt はこの状態を PoFx に内部的に保存して、プロセッサがアイドル状態を終了したときに後で状態を復元できるようにします。 プロセッサがアイドル状態に入る準備をした後、 ProcessorHalt は PEP の Halt コールバック ルーチンを呼び出してプロセッサを停止します。

PEP によるPEP_NOTIFY_PPM_IDLE_EXECUTE通知の処理の一環として、PEP はプロセッサを PEP が選択したアイドル状態に移行する必要があります。 プロセッサのアイドル状態を入力する 2 つの方法を次に示します。

• プロセッサのキャッシュが一貫性を保ち、すべてのシステムとプロセッサの状態が維持されるプロセッサアイドル状態の場合、PEP は最初に ProcessorHalt を呼び出さずにアイドル状態に直接入ることができます。
• プロセッサのキャッシュが一貫性を保たないプロセッサアイドル状態、またはプロセッサ ハードウェア コンテキストが保持されていないアイドル状態の場合、PEP はプロセッサをアイドル状態に移行する前に ProcessorHalt を呼び出す必要があります。

• PROCESSOR_HALT_CONTEXT_RETAINED = 1、PROCESSOR_HALT_RETURN_NOT_SAFE = 1

  PEP の Halt コールバック ルーチンは、コンテキストが保持されている任意の状態からを返す必要があります。

• PROCESSOR_HALT_CACHE_FLUSH_OVERRIDE = 1、PROCESSOR_HALT_CACHE_COHERENT = 1

  cache-flush-override フラグは、キャッシュの一貫性のないアイドル状態に入る場合 にのみ 設定する必要があります。

• PROCESSOR_HALT_CACHE_FLUSH_OVERRIDE = 0、PROCESSOR_HALT_CACHE_COHERENT = 0

  キャッシュの一貫性のない停止には、cache-flush-override フラグを設定する必要があります。

• PROCESSOR_HALT_CONTEXT_RETAINED = 0、PROCESSOR_HALT_CACHE_COHERENT = 1

  プロセッサ ハードウェア コンテキストを失うアイドル状態 (したがって 、マルチプロセッサ パーキング プロトコル を使用してアイドル状態を終了し、オペレーティング システムに制御を返す) は、キャッシュに一貫性のある状態ではありません。

PEP は、IRQL <= HIGH_LEVELでこのルーチンを呼び出すことができます。

要件

こちらもご覧ください

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_IDLE_EXECUTE