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
• Running the HCK Test Suites from a Command Prompt window

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

If you have not already done so, follow the instructions in Provision a computer for driver deployment and testing (WDK 8.1). 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.

To select an HCK Test Suite to run on a test computer

1. From the Driver menu, select Test and then select Test Group Explorer.

2. In the Driver Test Group Explorer window, select 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, select 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.

To export a Test Suite

1. In the Test Group Explorer, select and hold (or right-click) the HCK Test Suite you want to copy and select 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

Copy 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.

To 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

• HCK Tests.Basic.Device.Device Fundamentals Test Suite
• HCK Tests.Basic.Device.Graphics Test Suite
• HCK Tests.Basic.Device.Imaging Test Suite
• HCK Tests.Basic.Device.Network.MobileBroadband.CDMA Test Suite
• HCK Tests.Basic.Device.Network.MobileBroadband.GSM Test Suite
• HCK Tests.Basic.Device.Network.WLAN Test Suite

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.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.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.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.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.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.

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
• Getting Started with Windows Debugging
• Hardware Certification Program
• Windows Hardware Certification Kit (HCK)
• How to test a driver at runtime from a Command Prompt