Running a Test Application

The following sequence lists the procedures used in a typical test. While the procedures listed assume a wave audio device driver, they apply to most test applications. For testing your device driver you should perform the following:

Set up the hardware and software environment

Configure the test application for the hardware

Select the test suites

Select logging

Run the automatic tests

Run the manual tests

Run individual tests

Setting Up the Hardware and Software Environment

Before running any test, you must set up your test environment. While your device driver might not be fully tested, you should be able to install it in the system and verify that it is functional.

·To set up your test environment:

1.Install and connect any hardware required for the test.

2.Set up Windows.

3.Install the test drivers using the Drivers option in the Control Panel.

4.Run Windows and verify the test driver is installed correctly. (For waveform drivers, play a WAV file using the Sound option.)

5.Copy the test application (for example, WAVETST) and any associated files to the test computer.

Setting Up a Test Application

Prior to running a test suite, you need to set up the test application for your test through the Test menu.

·To set up the input and output paths:

1.From the Test menu, select Set Input/Output Paths.

2.Set the paths to the correct directories.

For wave audio devices, the input path is the directory containing the wave files used for WAVETST. The output path is the destination directory for the log files. (The default directory for WAVETST is the directory containing WAVETST.)

Selecting Test Suites

The Test Suites specify the tests that will be run during the test.

·To select all of the test suites:

1.From the Test menu, choose Select Tests.

2.Choose Add All Cases.

3.Choose OK.

Setting Test Logging Options

Before running the test suites, set the test logging options to specify the type of logging desired and the destination of the logging messages.

·To log terse messages to a window and a file:

1.From the Test menu, choose Set Logging.

2.Set the Logging Output Level by selecting Terse.

3.Specify the File Logging Filename by entering the path and name of the test log; for example:

C:\LOGS\WAVETST1.LOG

4.Set the File Logging Level by selecting Terse.

5.Choose OK.

Running Automatic Tests

You should run the automatic tests before the manual tests. The automatic tests do not require any operator intervention. To run the automatic tests, choose Run Tests in the Test menu.

Some tests are quite long so you might not want to monitor their progress. (For example, wave device driver tests take up to 45 minutes to complete.) Even though you leave the tests unmonitored, you might want to check the test progress periodically.

Some faults encountered during a test can cause a test to abort, can cause the computer to hang, or can cause an unrecoverable application error. If a test fault interrupts the test sequence, restart the computer if necessary and read the log file to determine which test caused the fault. When you restart the automatic tests, you might select only those test cases which haven't run yet rather than selecting all test cases. (Choose Add Case instead of Add All Cases when selecting test cases.)

If you need more information about a test fault than the terse logging mode provides, rerun a test (or a series of tests) in the verbose mode.

Running Manual Tests

After you have run all of the automatic tests, you can run the manual tests. These tests require operator interaction and display dialog boxes during their operation.

To see which tests require manual interaction, choose Select Tests from the Test menu then choose the Interaction Required button.

·To run manual tests:

1.From the Test menu, choose Set Run Parms.

2.Set the Verification to Manual.

3.Choose OK.

Running Individual Tests

You might run individual tests to test a certain routine in device driver, or you might rerun a test to verify and test for a specific fault.

·To select individual tests:

1.From the Test menu, choose Select Tests.

2.Choose Remove All Cases to remove any previous test cases.

3.Select individual test cases and choose Add Case.

4.Choose OK.

5.From the Test menu, choose Run Tests.

When you run a test sequence, make sure you repeat any tests as necessary to check the different options available for your device driver. For example, test a wave audio device using all of the different wave formats that it supports. Also look for any faults that the test programs cannot detect. For example, listen for any extraneous clicking, popping, or hissing noises that a wave audio device might produce during playback.