Modifying the Waveform Audio Driver Test
The Waveform Audio Driver Test executes the s tux –o –d wavetest command line on default execution. This command plays and captures tones of 1 second in length on the first waveform device and performs basic functional testing. To perform in-depth testing of your driver, you must set up your device with a microphone and speaker and turn on interaction so that you can confirm that audio plays and records.
To set up the test correctly, connect a speaker and a microphone to the audio card simultaneously and place the microphone between 1 and 6 inches from the speaker. While you run the test for the first time, you may adjust this distance between the speaker and the microphone to reduce feedback and find the distance where the sound played by the test is similar to the sound that is recorded. A difference in volume between the sound played and the sound recorded is not a problem and is to be expected during the test.
You can modify the test by editing the command line. For information about how to edit the command line for a test, see Editing the Command Line for a Test. The following table shows the modifications you can make to the test.
To modify the Waveform Audio Driver Test
| To | Add this command-line parameter |
|---|---|
| Force the test to stop and prompt you for confirmation.
You can run the test with this command-line parameter to manually confirm that audio plays and records correctly. |
|
| Set the duration of the tone being played or captured for all test cases. Duration is given in units of seconds.
The default value is 1 second. |
|
| Enable half-duplex testing and disables sound output when capturing. You must supply your own sound into the microphone when the test attempts to record sound.
You need to use this parameter if your driver or hardware cannot play and capture sound simultaneously. |
|
| Specify which device to test.
If your device is not the default device, use this parameter to specify that the device must be tested. |
|
To specify one or more optional command-line entries in the test library, you must use the –c tux option. The -c option forces Tux to pass the optional command-line entry into the test library. For example, the s tux -o -d wavetest -c "-i -d 5 -e" command line runs the test interactively with tones of 5-second duration and tests the driver as a half-duplex driver.
The following table shows the test cases for the Waveform Audio Driver Test.
| Test case | Description |
|---|---|
| 100: Build Verification Test | Ensures that all components for the test are present. Refer to the test result to determine the likely cause of failure. Warnings that affect the behavior of the test will also appear in this test case if appropriate. This test case can cause other test cases to be skipped if the required components are not present. |
| 1000: Easy Playback | Exercises the PlaySound and sndPlaySound APIs on wave files in the Windows directory. |
| 2000: Playback Capabilities | Displays the capabilities reported by the driver, and lists the extended functions supported by the driver. |
| 2001: Playback | Plays a tone for all of the supported formats. |
| 2002: Playback Notifications | Plays using null, event, thread, function, and window callbacks that should be supported by the driver. |
| 2003: Playback Using Extended Functions | Plays changing extended functions such as pitch, rate and volume. |
| 3000: Capture Capabilities | Displays the capabilities reported by the driver. |
| 3001: Capture | Captures a tone for all of the supported formats. |
| 3002: Capture Notifications | Captures using thread, window and function callbacks that should be supported by the driver. |
Remarks
This test library can have one or more optional command-line entries to change the behavior of the test. To specify one or more optional command-line entries to the test library, you must use the –c command-line option. This option forces Tux to pass the specified string into the test library.
Full duplex drivers are typically tested with the s tux -o -d wavetest -c "-i -d 5" command line, which uses 5-second tones and prompts for confirmation.
Half duplex drivers are typically tested with the s tux -o -d wavetest -c "-i -d 5 -e" command line, which also uses 5-second tones and prompts for confirmation. You must provide sound when the device records because the hardware or driver does not support playback and capture simultaneously.
See Also
Last updated on Friday, October 08, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.