KS Topology Test - Win8

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 RT (ARM-based)
Windows 8 (x64)
Windows 8 (x86)
Windows Server 2012 (x64)

Expected run time

~12 minutes

Categories

Certification
Functional

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.

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

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

noteNote
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\

Show:
© 2014 Microsoft. All rights reserved.