Edit

PwrTest Monitor Scenario

  • Article

The PwrTest Monitor Scenario logs user idle statistics related to monitor or display auto-dimming and blanking.

When you run the PwrTest Monitor Scenario, you might want to also run the PwrTest Requests Scenario (/requests) scenario in another window. The PwrTest Requests Scenario might help to understand why the monitor might still be on or the system still awake, even though the user has been idle long enough for the idle timers to expire.

If you run both scenarios, be sure to use the /ln:name parameter so that you can change the log file and ETW trace session names. The names need to be different to avoid a conflict between the two instances of the tool.

Syntax

pwrtest.exe /monitor  [/t:n] [/?]

/t:n
Specifies the total time (in minutes) for the scenario to run (the default value for n is 30 minutes).

Examples

pwrtest.exe /device 

pwrtest.exe /device /t:60

XML log file output

<PwrTestLog>
  <SystemInformation>
  </SystemInformation>
  <MonitorPower> 
    <PhysicalMonitorBrightnessEvent>
        <Timestamp></TimeStamp>
        <PhysicalMonitorBrightnessPercent></PhysicalMonitorBrightnessPercent>
    </PhysicalMonitorBrightnessEvent>
    <MonitorIdleStatusEvent>
        <Timestamp></TimeStamp>
        <SessionId></SessionId>
        <AccruedIdleTimeMs></AccruedIdleTimeMs>
    </MonitorIdleStatusEvent>
    <MonitorTimeoutsChangeEvent>
        <Timestamp></TimeStamp>
        <SessionId></SessionId>
        <DisplayTimeoutValueMs></DisplayTimeoutValueMs>
        <ScreenSaverTimeoutValueMs></ScreenSaverTimeoutValueMs>
        <DimTimeoutValueMs></DimTimeoutValueMs>
        <DimBrightnessValue></DimBrightnessValue>
        <NormalBrightnessValue></NormalBrightnessValue>
    </MonitorTimeoutsChangeEvent>
    <MonitorIdleActionExpireEvent>
        <Timestamp></TimeStamp>
        <SessionId></SessionId>
        <IsConsoleSession></IsConsoleSession>
        <IdleAction></IdleAction>
        <IdleStartTime></IdleStartTime>
        <TimeoutValueMs></TimeoutValueMs>
    </MonitorIdleActionExpireEvent>
    <MonitorPowerEvent>
        <Timestamp></TimeStamp>
        <SessionId></SessionId>
        <IsConsoleSession></IsConsoleSession>
        <NewState></NewState>
        <PreviousState></PreviousState>
        <PreviousStateTime></PreviousStateTime>
    </MonitorPowerEvent>
    <MonitorAdaptiveDimTimeoutEvent>
        <Timestamp></TimeStamp>
        <Timeout></Timeout>
    </MonitorAdaptiveDimTimeoutEvent>
  </MonitorPower>
</PwrTestLog>

The following table describes the XML elements that appear in the log file.

Element Description
<MonitorPower>

Contains all the different monitor power events. There can be only one <MonitorPower> element in a PwrTest log file.
<Timestamp>

Time stamp of any given event.
<SessionId>

The name of the user session the event is for.
<IsConsoleSession>

Shows whether the physical console session is attached to the physical monitor .
<PhysicalMonitorBrightnessEvent>

Event indicates the current monitor brightness.
<MonitorIdleStatusEvent>

Event indicates the user is idle.
<AccruedIdleTimeMs>

Accrued user idle time in milliseconds.
<MonitorTimeoutsChangeEvent>

Event indicates the current idle timeouts.
<DisplayTimeoutValueMs>

Displays blank timeout value in milliseconds.
<ScreenSaverTimeoutValueMs>

Screen saver timeout value in milliseconds.
<DimTimeoutValueMs>

Displays the dim timeout value in milliseconds
<DimBrightnessValue>

Brightness to use when in the dim state.
<NormalBrightnessValue>

Brightness to use when in on state.
<MonitorIdleActionExpireEvent>

Event indicates an idle timeout was hit and an action was taken.
<IdleAction>

Describes the action that was taken (screen saver start, console locked, monitor dim, monitor blank).
<IdleStartTime>

Start time of this idle state.
<TimeoutValueMs>

Timeout value of this idle state in milliseconds.
<MonitorPowerEvent>

Event indicates a display idle timeout was hit and an action was taken.
<NewState>

New state of the monitor (on/dim/off).
<PreviousState>

Previous state of the monitor (on/dim/off).
<PreviousStateTime>

Time that was spent in the previous state.
<MonitorAdaptiveDimTimeoutEvent>

Event indicates the adaptive dim timeout has changed.
<Timeout>

New timeout value in seconds.

PwrTest Syntax