Intel 05-1832-002 User Manual
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.
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
up a
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, use
sampling rate, and bits per sample, use
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
-1 if failure
Includes:
srllib.h
dxxxlib.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
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
order of playback and the location of voice data. See
for information about the data structure.