Export (0) Print
Expand All

WDTF Runtime Library

WDTF runtime library is available as part of the Windows Driver Kit (WDK). When you install the WDK, you also install the Windows Driver Test Framework (WDTF). The templates and sample files for testing and development are installed along with the WDK. The WDTF runtime library needs to be installed on any system that you want to run WDTF-based tests on. This includes the tests provided in the WDK and tests you write using WDK test templates.

The WDK also includes a separate installation package (*.msi) that you can use to install the WDTF runtime on a test computer. The WDK includes The MSI does the following:

  • Copies files.

  • Adds registry keys.

  • Registers WDTF objects.

  • Install and uninstalls a log file.

The WDTF runtime library includes tools to help you triage and run tests.

Name of tool or command scriptDescription
CheckWDTFInstall.cmd

Verifies that WDTF was installed correctly. Running this command creates the file CheckWDTFInstall.log, which contains information on all installed WDTF components.

DisplayDeviceClass.vbs

Displays device class information that exist on the current system. Both the Class GUID and Class Friendly name is shown. Useful when trying to create /DQ queries that look for certain class of devices.

DisplayDeviceDataFields.cmd

Displays device class information that exist on the current system. Both the Class GUID and Class Friendly name is shown. Useful when trying to create /DQ queries that look for certain class of devices.

DisplayDevices.vbs

Displays information about each device expressed by the /DQ parameter, the default is all device in the system.

DisplayDevicesWithWDTFilters.vbs

Displays any device that has one of the WDTF filter drivers installed on it. WDTF has 3 filter drivers: EDT, IOSPY, or the button driver.

DisplayDeviceTree.vbs

Displays the device tree of the current system.

DisplaySystemDataFields.cmd

Displays all the system namespaces and the fields they have.

 

How to install the WDTF runtime library

When you set up a test computer for deployment, following the instructions Configuring a Computer for Testing and Debugging, the WDTF runtime library is installed on the test computer.

You can also install the WDTF runtime library manually.

Hh831856.wedge(en-us,VS.85).gifInstalling WDTF on a test computer (preferred method)

  1. Install Visual Studio and then install the WDK.

  2. Configure a remote computer for testing (Driver > Test > Configure Computers).

Hh831856.wedge(en-us,VS.85).gifManually installing WDTF on a test computer (alternative method)

  1. Install Visual Studio and the WDK on the computer you use for development.
  2. Copy the WDTF installation files from the computer where you installed the WDK to the test computer. The WDTF installation files (*.msi and *.cab files) are located in the %programfiles%\Windows Kits\8.0\Testing\Runtimes directory on your development system. Copy the all the files in the directory that matches the architecture of the test computer.
  3. On the test computer, open a Command Prompt window using elevated permission (Run as administrator) and navigate to the directory that contains the WDTF installation files. Run the following command to install WDTF.
    msiexec /i "Windows Driver Testing Framework (WDTF) Runtime Libraries-x64_en-us.msi"
    
    

    -Or-

    msiexec /i "Windows Driver Testing Framework (WDTF) Runtime Libraries-x86_en-us.msi"
    
    

The following table describes the options you can use with the msiexec command.

OptionDescription

/l* filename

Writes all messages and errors to a file.

WDTFDIR=CustomInstallationDirectory

Specifies a destination directory for WDTF Runtimes. Default WDTFDir is %programfiles%\Windows Kits\8.0\Testing\Runtimes\WDTF

WDTF_SKIP_MACHINE_CONFIG=[1 | 2]

Specify 1 to skip setting cscript.exe as the default script engine.

Specify 2 to skip enabling AC and DC RTC wake.

/?

Shows help for msiexec.exe options.

 

Example

msiexec /i "Windows Driver Testing Framework (WDTF) Runtime Libraries-x64_en-us.msi" /l* WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1

How to determine if the WDTF runtime library is installed on a computer

You can verify that WDTF was installed correctly by running a command script on the test computer. Running this command creates the file CheckWDTFInstall.log, which contains information on all installed WDTF components.

  1. Open a Command Prompt window on the test computer.
  2. Run %WDTFDir%\Tools\CheckWDTFInstall.cmd.
  3. Open the log file CheckWDTFInstall.log and examine the results.

How to uninstall the WDTF runtime library

When you set up a test computer for deployment, following the instructions Configuring a Computer for Testing and Debugging, the WDTF runtime library is installed on the target computer.

You can remove the WDTF runtime library by removing provisioning from the target computer. For more information, see "Removing provisioning from the target computer" under Configuring a Computer for Testing and Debugging.

You can also uninstall the WDTF runtime library manually.

Hh831856.wedge(en-us,VS.85).gifManually uninstalling WDTF on a test computer

  1. On the test computer, go to Control Panel\Programs\Programs and Features.

  2. Locate the Windows Driver Testing Framework (WDTF) Runtime Libraries and right click (Uninstall)).

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft