Terminal Server PNP Redirection Testing Overview

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

These procedures test your Windows Portable Device (WPD) over Terminal Server for correct functionality by using the Microsoft Windows Driver Kit (WDK) and Driver Test Manager (DTM). To ensure full functionality, you must run all of the tests that DTM identifies as required for the device. If your product provides bus-specific support, you must run the appropriate bus-specific tests in addition to the standard tests.

Note   You must use the latest version of the WDK to compile your driver in order for it to pass testing and obtain a logo.

The test procedures are divided into the following types of topics:

  • Overview: The overview topics describe the hardware, software, and tester knowledge requirements.

  • Preparing: The preparing topics describe how to configure the system or systems for Windows logo testing.

  • Running: The running topics describe how to run the tests for your device or system.

Run time: approximately 1-2 hours

Hardware Requirements

The following hardware is required for Terminal Server Plug and Play (PnP) redirection testing:

  • Two computers that are running Windows Vista (the Terminal Server (TS) client computer and Terminal Server (TS) server computer).

  • An internal or external USB port connected to the TS client computer. USB 2.0 is recommended.

  • A WPD device connected with a USB cable to the TS client computer.

  • The TS server computer must be running Windows Vista, Enterprise Edition or Windows Vista, Ultimate Edition.

Note   Testing a device to obtain a logo for Server Device qualification requires that the system being used to test the device supports four processors and a minimum of 1 GB of RAM. These system capabilities are required for the "Dynamic Partitioning (DP) Simulator and Test" and the "Multiple Processor Group" test to run. You do not need a system that actually supports DP capabilities or has greater than 64 processors to test your device.

If a pool of systems is used to test devices, at least one system in the pool must contain four processors and a minimum of 1 GB of RAM. Additionally, that system must contain the device and driver being tested. As long as the driver is the same on all systems in the pool, the schedule will be created to run against all systems.

For those tests that do not include a driver to test, such as testing a hard drive, the Driver Test Manager (DTM) scheduler will constrain the DP test to run on the default system. This system should also be manually configured to have multiple processor groups. The default system is the first one listed. Test personnel, in this case, should ensure that this first system meets these minimum hardware requirements.

Note   Except for Para-Virtualization drivers (as defined by Logo Requirement Policy-0020), physical devices and their associated drivers being tested for Server Logo or Signature may not be tested in virtual machines using any form of virtualization. This is because not all virtualization products support the underlying functionality needed to pass the tests relating to Multiple Processor Groups, Device Power Management, Device PCI functionality, etc.

Other Device Requirements

The following software is required to run the Terminal Server PNP redirection tests:

Note  These tests apply only to Cellular Handsets devices that install third-party (that is, vendor-supplied) WPD drivers. If you are not providing a WPD driver for your Cellular Handset device, you are not required to run these tests for your device, even though the jobs might appear in the Device Console.

  • For cellular handsets, you must have the driver for the Windows Portable Devices (WPD) cellular phone. The driver INF file must install the device as a WPD class with the following ClassGUID:

    Class=WPD
ClassGUID={EEC5AD98-8080-425f-922A-DABF3DE3F69A}

  • Your device must appear under "Windows Portable Device" or "Portable Device" in Device Manager.

  • You need to update your driver .inf file to be able to support TS PNP Device Redirection. Read the "Device Driver INF Changes for Plug and Play Device Redirection on Terminal Server" section located in the link: Device Driver INF Changes for Plug and Play Device Redirection on Terminal Server

Tester Knowledge Requirements

To run the Terminal Server PNP redirection tests, testers must know how to:

  • Plug a device into a USB port of the computer and maintain the connectivity throughout the test run.

  • Provide continuous power to the device throughout the test run.

  • Troubleshoot device installation to make sure that the device is installed successfully by using Device Manager or by looking at the SetupAPI device installation logs.

This section contains the following topics:

Preparing for Terminal Server PNP Redirection Testing

Running the Terminal Server PNP Redirection Tests

Troubleshooting Terminal Server PNP Redirection Testing

Windows Marketplace Tested Products List

Windows Debugging Tools

Windows Symbol Files

 

 

Build date: 9/14/2012