Intel 05-1832-002 User Manual

Page of 564
Voice API for Windows Operating Systems Library Reference — November 2003
299
play recorded voice data — dx_play( )
dx_play( )
play recorded voice data
!
!
!
Description
The dx_play( ) function plays recorded voice data, which may come from any combination of data 
files, memory, or custom devices. In the case of DM3 boards, voice data may also come from 
already downloaded cached prompts.
For a single file synchronous play, dx_playf( ) is more convenient because you do not have to set 
up a 
 structure. See the 
 function description for more information.
To specify format information about the data to be played, including file format, data encoding, 
sampling rate, and bits per sample, us
Name:
int dx_play(chdev, iottp, tptp, mode)
Inputs:
int chdev 
valid channel device handle
DX_IOTT *iottp 
pointer to I/O Transfer Table structure
DV_TPT *tptp 
pointer to Termination Parameter Table structure
unsigned short mode
asynchronous/synchronous playing mode bit mask for this play session
Returns:
0 if success
-1 if failure
Includes:
srllib.h
dxxxlib.h
Category:
I/O
Mode:
asynchronous or synchronous
Platform:
DM3, Springware 
Parameter
Description
chdev 
Specifies the valid channel device handle obtained when the channel was 
opened using 
iottp 
Points to the I/O Transfer Table Structure, DX_IOTT, which specifies the 
order of playback and the location of voice data. See 
for information about the data structure.