Storage Performance USB3

  • Article

This test is a special variant of the Storage Performance CS test which verifies that a USB 3.0 storage device complies with the USB 3.0 Version 1.0 specification and that the device conforms to performance requirements. For more information about this test, see Storage Performance CS.

Test details

   
Specifications
  • Device.Storage.Hd.Usb3.Compliance
Platforms
  • Windows 10, client editions (x86)
  • Windows 10, client editions (x64)
  • Windows Server 2016 (x64)
Supported Releases
  • Windows 10
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10, version 1703
  • Windows 10, version 1709
  • Windows 10, version 1803
  • Windows 10, version 1809
  • Windows 10, version 1903
  • Next update to Windows 10
Expected run time (in minutes) 10
Category Benchmark
Timeout (in minutes) 600
Requires reboot false
Requires special configuration false
Type automatic

 

Additional documentation

Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):

Running the test

Before you run the test, complete the test setup as described in the test requirements: Removable Storage Testing Prerequisites. In addition, this test requires the following:

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

For troubleshooting information, see Troubleshooting Device.Storage Testing or the troubleshooting steps in Storage Performance CS.

More information

Command usage

Command Description

StorPerf.exe /DriveLetter [StorageDriveLetter] /DeviceTag USB3_BOT_Data

Runs the USB testing on the specified drive. DeviceTag can also be USB3_UAS_DATA for UAS-capable drives.

 

Command syntax

Command option Description

/DriveNumber <number>

Physical drive number of device under test.

Example: /DriveNumber 0

/DriveLetter <letter>

Drive letter of device under test.

Example: /DriveLetter C

/DeviceTag <value>

Identifies which TestcaseGroup or ComparisonGroup to select as the input from the configuration xml files. This parameter is case-sensitive and is used for indexing both the policy and comparison xml files.

Example: /DeviceTag CS_Boot

/PolicyXML <value>

The policy xml file name. Defines all of the parameters for running the I/O workloads. If no option is given, the default file will be generated.

Example: /PolicyXML CSPolicy.xml

/Compare <value> <value>

The two xml files to compare. These must have been generated from a previous run of this test. The "FinalTestCasesAggregated*.xml" files should be used instead of the "AllTestCasesAggregated*.xml" files since there is no guarantee that the number of iteration is the same for each test case.

Example: /Compare FinalTestCasesAggregated_42f4.xml FinalTestCasesAggregated_a732.xml

/CompareXML <value>

The comparison xml file name. Defines all of the parameters for running the comparison. If no option is given, the default file will be generated.

Example: /CompareXML CSCompare.xml

/PrintPolicy

Prints the policy table.

Note

   For command-line help for this test binary, type /h.

 

File list

File Location

StorPerf.exe

<[testbinroot]>\NTTest\driverstest\storage\wdk\

StorageAssessment.exe

<[testbinroot]>\NTTest\driverstest\storage\wdk\StorageAssessment\

StorageDevices.dll

<[testbinroot]>\NTTest\driverstest\storage\wdk\

StorageParameters.exe

<[testbinroot]>\NTTest\driverstest\storage\wdk\

 

Parameters

Parameter name Parameter description
LLU_NetAccessOnly User account for accessing test fileshare.
LLU_LclAdminUsr User account for running the test.
DeviceID Either DriveLetter or DriveNumber
DeviceTag
WDKDeviceID Instance path of device to test
QueryUAS Query Gatherer for UAS detection
DiskDeviceObjLink Assigned by Create Storage Parameters