POWER_REQUEST_TYPE列挙 (wdm.h)

  • [アーティクル]

POWER_REQUEST_TYPE列挙は、電源要求の種類を示します。

構文

typedef enum _POWER_REQUEST_TYPE {
  PowerRequestDisplayRequired,
  PowerRequestSystemRequired,
  PowerRequestAwayModeRequired,
  PowerRequestExecutionRequired
} POWER_REQUEST_TYPE, *PPOWER_REQUEST_TYPE;

定数

 
PowerRequestDisplayRequired
ドライバーでは使用されません。 詳細については、「解説」を参照してください。
PowerRequestSystemRequired
ユーザーが非アクティブな期間が経過した後に、コンピューターが自動的にスリープ モードに入らないようにします。
PowerRequestAwayModeRequired
ドライバーでは使用されません。 詳細については、「解説」を参照してください。
PowerRequestExecutionRequired
ドライバーでは使用されません。 詳細については、「解説」を参照してください。

注釈

この列挙は、カーネル モードの PoClearPowerRequest ルーチンと PoSetPowerRequest ルーチンで使用されます。 これらのルーチンを呼び出すドライバーは、 PowerRequestSystemRequired 列挙値を指定する必要があります。

他の 3 つの列挙値 (PowerRequestDisplayRequired、 PowerRequestAwayModeRequired、 PowerRequestExecutionRequired) は、ドライバーでは使用されません。 アプリケーションでは、 PowerSetRequest 関数と PowerClearRequest 関数の呼び出しで、これらの電源要求の種類 を 指定します。

PowerRequestDisplayRequired 電源要求には、次の効果があります。

  • ユーザーが一定時間非アクティブになると、セッションの表示はオンのままになり、自動的にはオフになりません。

  • ユーザーが非アクティブな期間が経過しても、スクリーンセーバーは自動的に開始されません。

  • ユーザーが非アクティブな期間が経過しても、セッションは自動的にロックされません。 ドライバーが電源要求を送信するときにセッションが既にロックされている場合、セッションはロックされたままになります。

PowerRequestSystemRequired は、PowerRequestDisplayRequired に加えて実行して、ディスプレイがオンのままで、システムが要求の期間中スリープ状態に入らないようにする必要があります。

PowerRequestAwayModeRequired 電源要求が有効になっている間に、ユーザーがコンピューターをスリープ モードにしようとした場合 (たとえば、[開始] をクリックして [スリープ] をクリックするなど)、電源マネージャーはオーディオとビデオをオフにして、コンピューターがスリープ モードに見えるようにしますが、コンピューターは引き続き実行されます。 これは、従来のスリープ (S3) システムにのみ適用されます。

PowerRequestExecutionRequired 電源要求が有効になっている間、呼び出し元プロセスは、プロセス有効期間管理 (PLM) メカニズムによって中断または終了されるのではなく、引き続き実行されます。 プロセスの実行が許可されるタイミングと期間は、オペレーティング システムと電源ポリシーの設定によって異なります。 この種類の電源要求は、Windows 8 以降でサポートされています。

DC 電源のモダン スタンバイ システムでは、電源要求は 5 分後に終了します。

従来のスリープ (S3) システムの PowerRequestAwayModeRequired を除き、電源要求はユーザーが開始したシステム スリープ エントリ (電源ボタン、カバーを閉じる、または [スタート] メニューから [スリープ] を選択) に終了します。

要件

要件 値
サポートされている最小のクライアント Windows 7 以降でサポートされています。
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h、Ntpoapi.h を含む)

こちらもご覧ください

PoClearPowerRequest

PoSetPowerRequest

PowerClearRequest

PowerSetRequest