Intel 05-1832-002 User Manual

19

Convenience functions enable you to easily implement certain basic functionality of the library 
functions. I/O convenience functions simplify synchronous play and record. 

 function performs a playback from a single file by specifying the filename. The 

same operation can be done by using 

 and supplying a 

 structure with only one 

entry for that file. Using dx_playf( ) is more convenient for a single file playback because you do 
not have to set up a DX_IOTT structure for the one file and the application does not need to open 
the file. 

 provides the same single-file convenience for the 

 function.

 function also plays voice data stored in a single VOX file. This function 

internally calls 

. Similarly, 

 records VOX files using 

The I/O convenience functions are:

 

plays voice data from a single VOX file without the need to specify DX_IOTT

plays voice data from a single VOX file using 

plays voice data stored in a single WAVE file

 

records voice data from a channel to a single VOX file without the need to specify DX_IOTT

records voice data from a channel to a single VOX file using 

 records voice data to a single WAVE file

The streaming to board feature enables real time data streaming to the board. Streaming to board 
functions allow you to create, maintain, and delete a circular stream buffer within the library. These 
functions also provide notification when high and low water marks are reached. See the Voice API 
Programming Guide for more information about the streaming to board feature.

The streaming to board functions include:

deletes a circular stream buffer

retrieves information about the circular stream buffer

creates and initializes a circular stream buffer