Freigeben über


PwrTest-Ausführungszustandsszenario

Das PwrTest-Ausführungszustandsszenario (/es) überwacht Die Änderungen des Threadausführungsstatus der derzeit ausgeführten Prozesse und Dienste.

Hinweis Dieses PwrTest-Ausführungszustandsszenario wird in erster Linie für Anwendungen verwendet, die legacy-APIs für Energieanforderungen verwenden, z. B. die SetThreadExecutionState-Funktion (Windows)). Verwenden Sie zum Überwachen von Anwendungen, die neuere Energieanforderungs-APIs verwenden, z. B. die PowerSetRequest-Funktion (Windows), stattdessen das PwrTest-Anforderungsszenario .

Anwendungen und Dienste können vorübergehend Energieverwaltungseinstellungen wie monitor- und Ruhezustandstimeouts außer Kraft setzen, indem sie ihren Threadausführungsstatus ändern. Das PwrTest-Ausführungszustandsszenario überwacht den Threadausführungsstatus und Systemstatusänderungen, die Anwendungen und Dienste mithilfe der Win32 SetThreadExecutionState-Funktion (Windows) vorgenommen haben.

Sie können das /es-Szenario zusammen mit PwrTest-Leerlaufszenario verwenden, um die Anwendungen und Dienste zu identifizieren, die verhindern, dass der Monitor oder das System in den Leerlauf wechselt.

Syntax

pwrtest /es  [/t:n] [/stes:{y|n}] [/rss:{y|n}] [/sss:{y|n}] [/all] [/user] [/kernel] [/idle] [/?] 

/t:n
Gibt die Gesamtzeit (in Minuten) für die Ausführung des Szenarios an (der Standardwert für n beträgt 30 Minuten).

/stes:{y|n}
Gibt an, ob SetThreadExecutionState-Ereignisse protokolliert werden sollen (y (ja) ist die Standardeinstellung).

/rss:{y|n}
Gibt an , ob RegisterSystemState-Ereignisse protokolliert werden sollen (y (ja) ist die Standardeinstellung).

/sss:{y|n}
Gibt an , ob SetSystemState-Ereignisse protokolliert werden sollen (y (ja) ist die Standardeinstellung).

/Alle
Gibt an, dass alle Ereignisse protokolliert werden sollen (SetThreadExecutionState, RegisterSystemState, SetSystemState).

/Benutzer
Gibt an, dass alle Benutzerereignisse protokolliert werden sollen (SetThreadExecutionState).

/Kernel
Gibt an, dass nur Kernelmodusereignisse protokolliert werden sollen (RegisterSystemState, SetSystemState).

/Im leerlauf
Protokollstatistiken im Leerlauf.

Beispiele

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 

Ausgabe der XML-Protokolldatei

<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> 

In der folgenden Tabelle werden die XML-Elemente beschrieben, die in der Protokolldatei angezeigt werden.

Element Beschreibung
<ExecutionState>

Enthält Informationen im Zusammenhang mit dem Ausführungsstatusszenario. In einer PwrTest-Protokolldatei kann nur ein <ExecutionState-Element> vorhanden sein.

<EsChange>

Enthält Informationen zu einem einzelnen Threadausführungsstatus-Änderungsereignis. Es wird ein <EsChange-Element> vorhanden sein.

<Zeit>

Gibt die Uhrzeit an, zu der das Ausführungsstatus-Änderungsereignis aufgetreten ist.

<Prozess>

Gibt den Pfad zur Imagedatei für den Prozess an, der die Ausführungsstatusänderung angefordert hat.

<RawState>

Gibt den Anforderungsausführungsstatus an. Dies ist ein 32-Bit-Wert vom Typ EXECUTION_STATE (siehe Windows.h).

<Kontinuierliche>

Gibt an, ob der Prozess die Ausführungsstatusänderung als fortlaufend (ES_CONTINUOUS) angefordert hat.

<System>

Gibt (TRUE) an, ob der Prozess angefordert hat, dass das System verfügbar ist (ES_SYSTEM_REQUIRED) oder nicht (FALSE).

<Anzeige>

Gibt (TRUE) an, wenn der Prozess die Anzeige als verfügbar (ES_DISPLAY_REQUIRED) oder nicht (FALSE) angefordert hat.

<AwayMode>

Gibt (TRUE) an, ob der Prozess den Abwesenheitsmodus aktiviert (ES_AWAYMODE_REQUIRED) oder nicht (FALSE) angefordert hat.

PwrTest-Syntax