Handling Errors Generated by Audio Functions

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The waveform audio functions return a nonzero value when an error occurs. Windows Embedded CE provides functions that convert these error values into textual descriptions of the errors. The application still must examine the error values to determine how to proceed, but it can use a textual description in a dialog box to describe an error to the user. The following table shows the functions that are used to retrieve textual descriptions of audio error values.

Function Description

waveInGetErrorText

Retrieves a textual description of a specified waveform audio input error.

waveOutGetErrorText

Retrieves a textual description of a specified waveform audio output error.

The only audio functions that do not return error values are the waveInGetNumDevs and waveOutGetNumDevs functions. These functions return 0 if no device is present in a system or if they encounter any errors.

See Also

Concepts

Using the Waveform Audio Interface