PoRegisterSystemState 関数 (ntifs.h)

PoRegisterSystemState ルーチンは、特定のアクティビティが原因でシステムをビジーとして登録します。

構文

PVOID PoRegisterSystemState(
  [in, out] PVOID           StateHandle,
  [in]      EXECUTION_STATE Flags
);

パラメーター

[in, out] StateHandle

登録状態ハンドルの呼び出し元が指定したバッファーへのポインター。 バッファーのサイズ (バイト単位) は です sizeof(ULONG)。 NULL の場合、これは新しい登録です。 NULL 以外の場合、このパラメーターは 、PoRegisterSystemState の以前の呼び出しによって返されたハンドルを指します。

[in] Flags

次の値の 1 つ以上のビットごとの OR で指定されたアクティビティの種類を示します。

戻り値

PoRegisterSystemState は、後でシステムビジー状態を変更または登録解除するために使用するハンドルを返します。 ハンドルを割り当てられなかった場合は NULL を返します。

注釈

PoRegisterSystemState は、フラグで示されているように、システムビジー状態を登録します。 登録は、呼び出し元が PoRegisterSystemState の別の呼び出しで明示的に変更するか、 PoUnregisterSystemState の呼び出しで取り消すまで保持されます。

Flags パラメーターは、進行中のアクティビティの種類を指定します。 ドライバーは、フラグの任意の組み合わせを指定できます。

ES_CONTINUOUS設定すると、ドライバーが PoRegisterSystemState または PoUnregisterSystemState を呼び出して明示的に変更または取り消されるまで、ビジー状態が保持されます。

ドライバーは、システムビジー状態を設定して、ドライバーアクティビティの実行中にシステムの電源状態がシステム動作状態 (S0) から切り替わるのを防ぐよう電源 マネージャー に要求できます。 ただし、一部の状況 (非常に低いバッテリなど) では、電源マネージャーがこの要求をオーバーライドし、システムをスリープ状態にすることがあります。

システムの電源状態を設定するには、 PoSetSystemState を呼び出します。

要件

こちらもご覧ください

PoSetSystemState

PoUnregisterSystemState