Device Install Check for Other Device Stability

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 verifies that no device or driver, except the device under test, has been affected by the device(s)/driver(s) install OR co-install process.

Details

No driver or device installs or co-installs are permitted to affect other drivers and/or their functionality in any way.

Run Time: 30 minutes

Log File: DeviceScan.wtl

System Restart Required: No

Test Category: Device Fundamental

Program: DeviceScan

Requirements

Software Requirements

Device Install Check for Other Device Stability test will run on the following Windows operating systems:

  • Windows 7

  • Software components included with the device that is being tested

Hardware Requirements

Device Install Check for Other Device Stability test tool requires the following hardware:

  • Device to be tested

  • Computer that meets the minimum software requirements

  • Hard drive with a minimum of 20 GB available on partition C:

Processor

Device Install Check for Other Device Stability test tool runs on the following processor architectures:

  • x86

  • amd64

Running Device Install Check for Other Device Stability

  1. Runs DeviceScan.exe with data acquisition mode.

    • This will scan status of all the devices attached to the test machine and store the device status information in PreInstallScan.xml

      Fail condition: Unexpected error in scan"

      Pass Condition: No unexpected failures

  2. Initiate device/driver reinstall Job.

    1. Verify that the specified Driver Package (A) is currently installed on the device.

    2. Do some Basic_IO, don't log failures.

    3. InstallFromInf(A).

    4. If #2 passed, do some more Basic_IO, log failures.

    5. Remove() -> Rescan() -> InstallFromInf(A).

    6. If #2 passed, do some more Basic_IO, log failures.

    7. InstallFromInf(NULL-Driver) -> InstallFromInf(A).

    8. If #2 passed, do some more Basic_IO, log failures.

    9. InstallFromInf(NULL-Driver) -> Rollback.

    10. If #2 passed, do some more Basic_IO, log failures.

    11. Go back to #3 'Count' times.

      Pass condition If Reinstall_With_IO Job passes

      Fail Condition: If Reinstall_With_IO Re Install Job fails

  3. Run DeviceScan.exe with Diff Mode.

    • This will scan status of all the devices attached to the test machine and store the device status information in PostInstallScan.xml

    • Compare the PreInstallScan.xml with PostInstallScan.xml and log the variations.

      Pass Condition: No mismatches in the status/missing nodes/added node found in the scan

      Fail Condition: At least one mismatch in the device status / missing / new devices found.

DeviceScan.exe [DA]/[DIFF]

Command option Description

DA

In this mode, devicescan tool will scan all the devices attached to the test machine and log the status in PreInstallScan.xml file.

DIFF

In this mode, devicescan tool will scan all the devices attached to the test machine and log the status in PostInstallScan.xml file, compare the PostInstallscan.xml with PreInstallScan.xml, and log the variation in "DeviceScan.wtl" file.

cscript.exe "Reinstall_With_IO.wsf" /WDTF /DeviceID:"[DeviceID]" /IOPeriod:[IOPeriod] /Cycles:[Cycles] [WDKLogo] 2>ScriptErrors.txt

Command option Description

/DeviceID

DeviceInstancePath of the device to reinstall its drivers for.

/IOPeriod

This is an optional parameter. The time (in msec) spent testing I/O between each reinstall testcase. Default value is 20000 msec

/Cycles

This is an optional parameter. Its value specifies the number of Test Cycles. Default value is 3.

WDKLogo

Run in 'Logo' mode. Running from DTM Device Console will set this.

File Manifest

File Location

DeviceScan.exe

[WTT\Testbinroot]\NTTEST\DRIVERSTEST\WDKTools\DeviceScan\

DeviceScan.wtl

Default Test result folder

ReInstall_With_IO.wsf

[WTT\Testbinroot]\NTTEST\WDTF\

ScriptErrors.txt

Default Test result folder

ScriptErrors.txt

Default Test result folder

Build date: 9/14/2012