Filter
Top Products
324 Voice API for Windows Operating Systems Library Reference — November 2003
dx_playvox( ) — play voice data stored in a single VOX file
dx_playvox( )
play voice data stored in a single VOX file
!
!!
! Description
The dx_playvox( ) convenience function plays voice data stored in a single VOX file. This
function calls dx_playiottdata( ).
!
!!
! Cautions
When playing or recording VOX files, the data format is specified in DX_XPB rather than through
the mode parameter of dx_playvox( ).
Name: SHORT dx_playvox(chdev, filenamep, tptp, xpbp, mode)
Inputs: int chdev
• valid channel device handle
char *filenamep
• pointer to name of file to play
DV_TPT *tptp
• pointer to Termination Parameter Table structure
DX_XPB *xpbp
• pointer to I/O Transfer parameter block structure
unsigned short mode
• play mode
Returns: 0 if successful
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: I/O Convenience
Mode: synchronous
Platform: DM3, Springware
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was
opened using dx_open( )
filenamep points to name of VOX file to play
tptp points to the Termination Parameter Table structure, DV_TPT, which specifies
termination conditions for this function. For more information on termination
conditions, see DV_TPT, on page 485.
xpbp points to the I/O Transfer Parameter Block structure, which specifies the file
format, data format, sampling rate, and resolution of the voice data. For more
information, see DX_XPB, on page 520.
If xpbp is set to NULL, this function interprets the data as 6 kHz linear
ADPCM.
mode specifies the play mode. The following two values must be ORed together:
• PM_TONE – play 200 msec audible tone
• EV_SYNC – synchronous operation (must be specified)