PwrTest の実行状態シナリオ
PwrTest 実行状態シナリオ (/es) は、現在実行中のプロセスとサービスのスレッド実行状態の変化を監視します
注: この PwrTest 実行状態シナリオは、主に SetThreadExecutionState 関数 (Windows)などのレガシー電源要求 API を使用するアプリケーションに使用されます。 PowerSetRequest 関数 (Windows)など、新しい電源要求 API を使用するアプリケーションを監視するには、代わりに PwrTest 要求シナリオを使用します。
アプリケーションとサービスは、スレッドの実行状態を変更することで、モニターやスリープ アイドル タイムアウトなどの電源管理設定を一時的にオーバーライドできます。 PwrTest 実行状態シナリオでは、アプリケーションとサービスが Win32 SetThreadExecutionState 関数 (Windows) を使用して行ったスレッド実行状態とシステム状態の変更を監視します。
/esシナリオを PwrTest Idle Scenarioと共に使用して、モニターまたはシステムがアイドル状態になるのを妨げているアプリケーションとサービスを特定できます。
構文
pwrtest /es [/t:n] [/stes:{y|n}] [/rss:{y|n}] [/sss:{y|n}] [/all] [/user] [/kernel] [/idle] [/?]
/t:n
シナリオを実行する合計時間 (分単位) を指定します ( nの規定値は 30 分)。
/stes:{y|n}
SetThreadExecutionState ( イベントをログに記録するかどうかを指定します (yはい) が既定です)。
/rss:{y|n}
RegisterSystemStateイベントをログに記録するかどうかを指定します (y (はい) が既定です)。
/sss:{y|n}
RegisterSystemStateイベントをログに記録するかどうかを指定します (y (はい) が既定です)。
/all
すべてのイベントをログに記録することを指定します (SetThreadExecutionState、 RegisterSystemState、 SetSystemState)。
/user
すべてのユーザー イベントをログに記録することを指定します (SetThreadExecutionState)。
/kernel
カーネル モード イベントのみをログに記録することを指定します (RegisterSystemState、 SetSystemState)。
/idle
アイドル状態の統計情報をログに記録します。
使用例
pwrtest /es /all
pwrtest /es /user
pwrtest /es /kernel
pwrtest /es /kernel /sss:n
pwrtest /es /kernel /rss:n
pwrtest /es /kernel /rss:y /sss:n
pwrtest /es /sss:n
pwrtest /es /rss:n /sss:n
pwrtest /es /stes:n
pwrtest /es /all /idle
XML ログファイルの出力
<PwrTestLog>
<SystemInformation>
</SystemInformation>
<ExecutionState>
<EsChange>
<Time>XX:XX:XX</Time>
<Process></Process>
<RawState></RawState>
<Continuous></Continuous>
<System></System>
<Display></Display>
<AwayMode></AwayMode>
</EsChange>
<EsChange>
<Time>XX:XX:XX</Time>
<Process></Process>
<RawState></RawState>
<Continuous></Continuous>
<System></System>
<Display></Display>
<AwayMode></AwayMode>
</EsChange>
</ExecutionState>
</PwrTestLog>
次の表では、ログ ファイルに表示されるXML要素について説明します。
| 要素 | 説明 |
|---|---|
| <ExecutionState> | 実行状態のシナリオに関連する情報が含まれています。 PwrTest ログ ファイルには <ExecutionState> 要素を 1 つだけ含めることができます。 |
| <EsChange> | 単一のスレッドの実行状態変更イベントに関連する情報が含まれています。 <EsChange>要素が 1 つ存在します。 |
| <時刻> | 実行状態変化イベントが発生した時間を示します。 |
| <Process> | 実行状態の変更を要求したプロセスのイメージ ファイルのパスを示します。 |
| <RawState> | 要求の実行状態を示します。 これは、EXECUTION_STATE型の32ビット値です (Windows.hを参照)。 |
| <継続的> | プロセスが継続的な実行状態の変更を要求したかどうかを示します (ES_CONTINUOUS)。 |
| <システム> | プロセスがシステムを使用可能にするように要求したか (ES_SYSTEM_REQUIRED)、要求しなかったか (FALSE) を示します (TRUE)。 |
| <表示> | プロセスがディスプレイを使用可能にするように要求したか(ES_DISPLAY_REQUIRED)、要求しなかったか (FALSE) を示します (TRUE)。 |
| <AwayMode> | プロセスが退席中モードを有効にするように要求したか (ES_AWAYMODE_REQUIRED)、要求しなかったか (FALSE) を示します (TRUE)。 |