KS Topology Test

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

KS Topology Test tests audio devices to make sure that the topology filters revealed behave properly and adhere to Microsoft requirements.

Details

KS Topology Test tests all the various components of the audio topology filters and the functioning of the filter as a whole to confirm proper behavior and adherence to Microsoft requirements. The tests check all filters, nodes, pins, node properties, and their layouts.

The KS Topology test checks:

• Nodes to make sure that the number of inputs and outputs is valid and numbered correctly and that their required properties are present. Also no orphaned nodes are allowed.

• Node properties to see if their messages are well formatted and behave as expected. The test checks KSPROPERTY_DESCRIPTION values, including the Access flags and the KSPROPERTY_MEMBERSHEADER structure for channel properties. Also the test makes sure that each channel exists and functions within the specified ranges.

• Pins for valid KsDataRange and KsDataFormat values. The pin DataFlow values are validated to make sure they comply with the general flow of the topology graph. Also no orphaned pins are allowed.

• Filters to make sure that the connections between nodes (internal connections) and between filters (physical connections) are valid and consistent. Also, a test checks to see if there is a valid path of connections between pins that correspond to physical jacks on an audio device and source/sink pins in the topology.

For details on the Microsoft requirements for Audio devices, please refer to the "Audio" Section under "Device and Driver Technologies" in MSDN.

Run Time:

**Log File:**KsTopTest.log

System Restart Required: No

Test Category:

Supported operating systems for Logo or Signature testing:

• Windows 7

• Windows Server 2008 R2

• Windows Vista

• Windows Server 2003

• Windows XP

Program:

Requirements

Software Requirements

The test tool requires the following software:

• Supported operating system (see list above).
• Software components included with the device that is being tested.

Supported Software

Hardware Requirements

• Device to be tested
• Computer that meets the minimum software requirements
• Windows keyboard
• Two-button pointing device
• Color display monitor capable of at least 1024 by 768 resolution, 32-bits per pixel, 60 Hz
• Hard drive with a minimum of 20 GB available on partition C:

Processor

• x86
• x64

Running KS Topology Test

All test cases return PASS or FAIL. Review the test results in the log file (KsTopTest.log) for specific details on failures.

Command Syntax

Code Tour

File Manifest

Build date: 9/14/2012