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