KS Topology Test - Win7

  • Article

This automated test validates audio devices to make sure that the topology filters function correctly and meet Microsoft® requirements. The test checks all filters, nodes, pins, node properties, and their layouts.

Parameter:

[WDKDeviceID] - set this parameter to device ID + instance ID when scheduling from Job Explorer for private testing

Please refer to WDK documentation for details about this test!

Test details

Associated requirements

Device.Audio.Base.AudioProcessing Device.Audio.Base.JackConnectorStateDescription Device.Audio.Base.JackDetection Device.Audio.Base.KSPROPERTYAUDIOVOLUMELEVEL Device.Audio.Base.KSTopologyCompliance Device.Audio.Base.NoUncontrollableStreamRouting Device.Audio.Base.ReportSupportedProperties Device.Audio.Base.VolumeControl

See the device hardware requirements.

Platforms

Windows 7 (x64) Windows 7 (x86) Windows Server 2008 R2 (x64)

Expected run time

~12 minutes

Categories

Certification

Type

Automated

 

Running the test

Before you run the test, complete the test setup as described in the test requirements: Audio Device Testing Prerequisites.

Troubleshooting

For troubleshooting information, see Troubleshooting Audio Testing.

Supporting Information

This test checks the following:

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

  • Node properties to determine whether their messages are well formatted and function as expected. The test checks KSPROPERTY_DESCRIPTION values, including the Access options 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 test validates the pin DataFlow values to make sure that 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, the test determines whether 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.

Note  

For detailed information about the Microsoft requirements for audio devices, see the "Audio" section under "Device and Driver Technologies" in MSDN®.

 

Command syntax

Command option Description

CScript DevIDparse.vbs /WDKDeviceID:[WDKDeviceID]

This command runs the KS Topology test job.

Note  

When you are scheduling from Job Explorer for private testing, set the [WDKDeviceID] option to the device ID plus instance ID.

 

 

Note  

For help with this test job, review the DevIDparse.vbs file in a text editor.

 

File list

File Location

DevIDParse.vbs

<testbinroot>\nttest\multimediatest\AVCore\Audio\WDK\

S98wtt.dll

<testbinroot>\nttest\multimediatest\AVCore\Audio\Profiles\

 

 

 

Send comments about this topic to Microsoft