POWER_REQUEST_TYPE 列挙 (ntpoapi.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 電源要求には、次の効果があります。

  • ユーザーが一定期間非アクティブになると、セッションの表示はオンのままになり、自動的にオフになりません。 ディスプレイが既にオフになっている場合は、電源要求によってディスプレイがオンになります。
  • スクリーンセーバーは、ユーザーが非アクティブな期間が経過した後に自動的に開始されることはありません。 スクリーンセーバーが既に実行されている場合、電源要求はスクリーンセーバーを停止します。
  • ユーザーが非アクティブな期間が経過しても、セッションは自動的にロックされません。 ドライバーが電源要求を送信するときにセッションが既にロックされている場合、セッションはロックされたままになります。
PowerRequestAwayModeRequired 電源要求が有効になっている間に、ユーザーがコンピューターをスリープ モードにしようとした場合 (たとえば、[開始] をクリックしてから [スリープ] をクリックするなど)、電源マネージャーはオーディオとビデオをオフにして、コンピューターがスリープ モードに見えるようにしますが、コンピューターは引き続き実行されます。

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

要件

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

こちらもご覧ください

PoClearPowerRequest

PoSetPowerRequest

PowerClearRequest

PowerSetRequest