How to run the HCK Test Suites in WDK 8.1

To make testing Windows drivers easier in the WDK, starting with WDK 8.1 you can now select HCK test suites to run on the test computers. The HCK test suites include the device fundamentals tests, and tests for graphics, imaging, wireless LAN, mobile broadband (CDMA and GSM), and WiFi Direct devices. These are the same tests that are used in the Windows Hardware Certification kit (Windows HCK). See Windows Certification Program for Hardware for information about the Windows HCK.

You can run the HCK test from a Command Prompt window or from Visual Studio. In addition, you can copy these tests to a new location—which might be another computer or a USB key drive—and run the tests from that location. Launching the tests automatically sets any local configuration needed to run the tests.

Running the HCK Test Suites on a test computer using Visual Studio

If you have not already done so, follow the instructions for Configuring a Computer for Testing and Debugging. After you have configured a test computer, the name of the test computer appears in the toolbar. Be sure you have select the test computer that you have configured for device you are testing with the HCK Test Suite.

Prepare the test computer as needed, by installing the device and driver and any additional requirements for test topology (see the HCK test prerequisites for the device you are testing). In place of the HCK Studio and HCK controller, you run the tests using Visual Studio and WDK 8.1.

Dn265574.wedge(en-us,VS.85).gifTo select an HCK Test Suite to run on a test computer

  1. From the Driver menu, click Test and then select Test Group Explorer.
  2. In the Driver Test Group Explorer window, click one of the HCK Test Suites.

    When you select a Test Suite, the Test Suite appears in the Driver Test Group window.

  3. Be sure you have selected the test computer that you have configured for device you are testing with the HCK Test Suite.
  4. To use the HCK test suites, you must also follow the configuration requirements for the device you are testing.
  5. You can use the check boxes to select the tests that match the architecture of the intended test computer (x86, x64, ARM).
  6. From the Driver menu, click Test > Run test. By default, the Run test command runs all of the tests in the currently selected test group.

You can also copy one of the provided HCK Test Suites and export it, along with the necessary test support files so that you can run the test suite from a Command Prompt window.

Dn265574.wedge(en-us,VS.85).gifTo export a Test Suite

  1. In the Test Group Explorer, right-click the HCK Test Suite you want to copy and click Export Test Suite... from the short-cut menu. (The command runs the CopyMe.cmd script).
  2. Select a destination folder for the test suite. You can export the test suite to a network share or to a USB flash drive.
  3. To run the HCK Test Suite, open a Command Prompt window on the test computer with elevated permissions. Navigate to the destination directory and run the RunMe.cmd script. For more information, see To run the HCK Test Suite from a Command Prompt window.

Running the HCK Test Suites from a Command Prompt window

Dn265574.wedge(en-us,VS.85).gifCopy the HCK Test Suite

  1. Open a Visual Studio Command Prompt window. Navigate to the %WindowsSdkDir%\Testing\Tests\HCK Tests\Basic directory. For example, C:\Program Files (x86)\Windows Kits\8.1\Testing\Tests\HCK Tests\Basic
  2. Run the CopyMe.cmd script and specify the name of test suite and destination directory. The script has the following syntax:
    CopyMe.cmd testSuite destinationPath
    
    The testSuite is one of the following:
    • Device.Device Fundamentals

    • Device.Graphics

    • Device.Imaging

    • Device.Network.MobileBroadband.CDMA

    • Device.Network.MobileBroadband.GSM

    • Device.Network.WLAN

    The destinationPath can be any valid path, including UNC paths. For example, you can copy an HCK Test Suite to a USB flash drive, or to a share on a server.

    C:\Program Files (x86)\Windows Kits\8.1\Testing\Tests\HCK Tests\Basic>CopyMe "De
    vice.Device Fundamentals" d:\temp\devfund
    Copying test target setup installers
    Copying TAEF and WDTF infrastructure
    Copying debuggers infrastructure
    Copying x86 tools
    Copying x64 tools
    Copying arm tools
    Copying test suite
    Copy complete!
    
    Run on any computer using an administrator command prompt in the same folder as
    the RunMe.cmd script.
    "RunMe.cmd <infFileName>"
    

Note  If the test computer is running Windows 7, you need to download and install the Microsoft .NET Framework 4.5 before you can run the HCK Test Suite.

Dn265574.wedge(en-us,VS.85).gifTo run the HCK Test Suite from a Command Prompt window

  1. On the test computer that you have configured for testing, open a Command Prompt window with elevated privileges (Run as administrator) and navigate to the directory where you copied the HCK Test Suite.

  2. Run the RunMe.cmd script and specify the path and name of the INF file. The script has the following syntax:
    RunMe.cmd infFileName
    

    For example:

    
    RunMe.cmd myDriver.inf
    

    Note  The Device.Graphics test suite does not make use of an INF file, however, the RunMe.cmd script requires an INF file. You can provide the name of substitute INF file if necessary.

HCT Test Suites

For information about specifying test parameters, see Device Fundamentals Test Parameters. If the device under test under test or one of its child devices is a WiFi adapter or a network device, you might need to set the Wpa2PskAesSsid, Wpa2PskPassword, or WDTFREMOTESYSTEM parameters.

HCK Tests.Basic.Device.Device Fundamentals Test Suite

Use this test suite for general reliability testing of all device types. You must follow the hardware, software, and test requirements for the HCK tests as described in the Device.Fundamentals Reliability Testing Prerequisites. In place of the HCK Studio and HCK controller, you run the basic tests using Visual Studio and WDK 8.1.

HCK Tests.Basic.Device.Device Fundamentals Test Suite
Hardware, software, and test requirements

Device.Fundamentals Reliability Testing Prerequisites

Test descriptions

DF - PNP (disable and enable) with IO Before and After (Basic)

DF - Sleep with IO Before and After (Basic)

 

HCK Tests.Basic.Device.Graphics Test Suite

Use this test suite to test graphics adapters or chipsets. You must follow the hardware, software, and test requirements for the HCK tests as described in the Graphic Adapter or Chipset Testing Prerequisites. In place of the HCK Studio and HCK controller, you run the basic tests using Visual Studio and WDK 8.1.

HCK Tests.Basic.Device.Graphics Test Suite
Hardware, software, and test requirementsGraphic Adapter or Chipset Testing Prerequisites
Test descriptionsGraphic Adapter or Chipset Tests

 

HCK Tests.Basic.Device.Imaging Test Suite

Use this test suite to test printers. The test suite uses tests that are part of the HCK Device.Imaging Testing. In place of the HCK Studio and HCK controller, you run the basic tests using Visual Studio and WDK 8.1.

HCK Tests.Basic.Device.Imaging Test Suite
Hardware, software, and test requirements

Printer Testing Prerequisites

Test descriptions

Printer Tests

 

HCK Tests.Basic.Device.Network.MobileBroadband.CDMA Test Suite

Use this test suite to test Mobile Broadband CDMA devices. Follow the guidelines for setting up and configuring your device as described in the Mobile Broadband Testing Prerequisites. In place of the HCK Studio and HCK controller, you run the basic tests using Visual Studio and WDK 8.1.

HCK Tests.Basic.Device.Network.MobileBroadband.CDMA Test Suite
Hardware, software, and test requirements

Mobile Broadband Testing Prerequisites

Test descriptions

CDMA Tests

 

HCK Tests.Basic.Device.Network.MobileBroadband.GSM Test Suite

Use this test suite to test Mobile Broadband GSM devices. Follow the guidelines for setting up and configuring your device as described in the Mobile Broadband Testing Prerequisites. In place of the HCK Studio and HCK controller, you run the basic tests using Visual Studio and WDK 8.1.

HCK Tests.Basic.Device.Network.MobileBroadband.GSM Test Suite
Hardware, software, and test requirements

Mobile Broadband Testing Prerequisites

Test descriptions

GSM Tests

 

HCK Tests.Basic.Device.Network.WLAN Test Suite

Use this test suite to test Wireless LAN (802.11) devices. Follow the guidelines for setting up and configuring your device as described in the Wireless LAN (802.11) Testing Prerequisites for the HCK. In place of the HCK Studio and HCK controller, you run the basic tests using Visual Studio and WDK 8.1.

HCK Tests.Basic.Device.Network.WLAN Test Suite
Hardware, software, and test requirements

Wireless LAN (802.11) Testing Prerequisites

Test descriptions

WLAN L1 Tests

 

Related topics

How to test a driver a runtime using Visual Studio
How to select and configure the Device Fundamentals Tests
Deploying a Driver to a Test Computer
Setting Up Kernel-Mode Debugging in Visual Studio
Hardware Certification Program
Windows Hardware Certification Kit (HCK)
How to test a driver at runtime from a Command Prompt

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft