Share via

USB Driver Level Re-Enumeration Test

  • Article

Note  This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.

Type: Automated Test

Overview

This test checks if a USB device connected to a system (but not directly to the root hub) can properly handle the IOCTL_INTERNAL_USB_CYCLE_PORT request. This request is basically another way to re-enumerate the driver of the USB device.

Details

This test checks whether the device is connected to the root hub. When it is ensured that a USB device is connected to the intermediate hub, perform an IOCTL_INTERNAL_USB_CYCLE_PORT request to all the USB hub ports. The test then sleeps for 15 seconds and finally compares the state and existence of the USB device before and after performing the IOCTL_INTERNAL_USB_CYCLE_PORT request on all ports. If the state and existence of the USB device(s) found are the same, then the test passes. If the device(s) do not match, then the test logs which device(s) were not found after the request (IOCTL_INTERNAL_USB_CYCLE_PORT) was performed.

Run Time: 3 minutes

Log File: USBVirtTest.wtl

System Restart Required: No

Test Category:

Supported operating systems for Logo or Signature testing:

  • Windows 7

Program: USBVirtTest.exe

Requirements

Software Requirements

The test tool requires the following software:

  • Supported operating system (see list above)

  • Software components included with the device that is being tested

Hardware Requirements

The test tool requires the following hardware:

  • Device to be tested

  • Computer that meets the minimum software requirements

Processor

The test tool runs on the following processor architectures:

  • x86

  • x64

  • IA64

Running the Test

All test cases return Pass or Fail.

To run this test:

  1. Install the DevED MSI.

  2. Copy the binaries.

  3. Install the driver.

  4. Run the USBVirtTest. Execute the application with or without parameters (you can specify the VID/PID as parameters in the command line syntax).

  5. Uninstall the driver:

  6. Uninstall the DevED MSI.

Command Syntax

Command option Description

UsbVirtTest.exe

Without any options, the test runs for all USB devices attached to the system.

[VID] [PID]

The Vendor ID and Product ID of the device under test, where [VID] and [PID] are replaced by the actual Vid and Pid of the device. This parameter can be replaced by using the Device Instance ID parameter

[Device Instance Path]

The device instance path of the device to be tested. This parameter can be used instead of the VID PID parameter

 

Code Tour

File Manifest

File Location

UsbVirtTest.exe

[WTT\TestBinRoot]\NTTEST\DRIVERSTEST\usb\LogoKit\USBVirtTest

USBVirtTest.cat

WTT\TestBinRoot]\NTTEST\DRIVERSTEST\usb\LogoKit\USBVirtTest

USBVirtTest.inf

[WTT\TestBinRoot]\NTTEST\DRIVERSTEST\usb\LogoKit\USBVirtTest

USBVirtTest.sys

[WTT\TestBinRoot]\NTTEST\DRIVERSTEST\usb\LogoKit\USBVirtTest

WTTlog.dll

[WTT\OSBinRoot]\WTT

devcon.exe

[WTT\OSBinRoot]\idw

DevEDInstaller.msi

[WTT\TestBinRoot]\NTTEST\DRIVERSTEST\usb\DevED

 

 

 

Build date: 9/14/2012