Filter
Top Products
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 DX_IOTT structure. See the dx_playf( ) 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 dx_playiottdata( ).
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 dx_open( ).
iottp Points to the I/O Transfer Table Structure, DX_IOTT, which specifies the
order of playback and the location of voice data. See DX_IOTT, on page 509,
for information about the data structure.