PwrTest Disk Scenario

The PwrTest Disk Scenario monitors disk idle statistics and spin-down events.

This scenario is primarily used for Windows 7 hard disk power activity, subsequent versions of Windows use a different mechanism for tracking disk idle that is not currently supported by Pwrtest. For versions of Windows newer than Windows 7, use the Windows Performance Toolkit (WPT). The WPT includes the Windows Performance Recorder (WPR) that you can use to trace the kernel-mode power provider and the Windows Performance Analyzer (WPA) that can show the power framework (PoFx) device statistics and can graph the transitions afterward.

Note   This scenario does not work for all types of disks or controllers because not all storage drivers register for idle detection. See Handling PnP Start in a Storage Class Driver for more information.

Syntax

pwrtest /disk  [/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 /disk /t:60
pwrtest /disk

XML log file output

<PwrTestLog>
  <SystemInformation>
  </SystemInformation>
  <DiskIdleEvents> 
    <DiskIdleChangeEvent>
        <Timestamp></TimeStamp>
        <DiskNumber></DiskNumber>
        <InstancePath></InstancePath>
        <Description></Description>
    </DiskIdleChangeEvent>
    <DiskIdlePolicyChange>
        <Timestamp></TimeStamp>
        <Timeout></Timeout>
        <IgnoreThreshold></IgnoreThreshold>
    </DiskIdlePolicyChange>
    <DiskIdleEvent>
        <Timestamp></TimeStamp>
        <DiskNumber></DiskNumber>
        <InstancePath></InstancePath>
        <Device></Device>
        <Pdo></Pdo>
        <BusyCount></BusyCount>
        <AccruedBusyCount></AccruedBusyCount>
        <IdlePowerState></IdlePowerState>
        <CurrentPowerState></CurrentPowerState>
        <Timeout></Timeout>
        <IgnoreThreshold></IgnoreThreshold>
        <AccruedIdleTime></AccruedIdleTime>
        <AccruedNonIdleTime></AccruedNonIdleTime>
        <Analysis></Analysis>
    </DiskIdleEvent>
  </DiskIdleEvents>
</PwrTestLog> 

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

Element Description
<DiskIdleEvents>

Contains all the different disk idle events. Only one <DeviceIdleEvents> element per PwrTest log file.

<Timestamp>

Time stamp of any given event.

<DiskNumber>

Identifies which physical disk is this event for.

<InstancePath>

Device instance path.

<DeviceIdleChangeEvent>

Device add or remove event.

<Description>

DeviceRemoved or DeviceDetected.

<DiskIdlePolicyChange>

Disk timeouts change event.

<Timeout>

New disk spin-down timeout.

<IgnoreThreshold>

New disk idle ignore threshold.

<Device>

Functional device object.

<Pdo>

Physical device object

<BusyCount>

The number of times the device driver called PoSetDeviceBusy during the period.

<AccruedBusyCount>

The number of times the device driver call PoSetDeviceBusy total.

<IdlePowerState>

What numeric state is the idle state.

<CurrentPowerState>

The current numeric power state.

<Timeout>

Timeout (in seconds).

<IgnoreThreshold>

The number of seconds of non-idle time to ignore

<AccruedIdleTime>

The accrued idle time during the period.

<AccruedNonIdleTime>

The total idle time that has accrued.

<Analysis>

String that describes what happened during the period.

PwrTest Syntax