Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 327
play voice data stored in a single WAVE file — dx_playwav( )
dx_playwav( )
play voice data stored in a single WAVE file
!
!!
! Description
The dx_playwav( ) convenience function plays voice data stored in a single WAVE file. This
function calls dx_playiottdata( ).
The function does not specify a DX_XPB structure because the WAVE file contains the necessary
format information.
!
!!
! Cautions
This function fails when an unsupported WAVE file format is attempted to be played. For
information on supported data formats, see the description for DX_XPB, on page 520 and the Voice
API Programming Guide.
Name: SHORT dx_playwav(chdev, filenamep, tptp, 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
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( )
tptp points to the Termination Parameter Table structure, DV_TPT, which specifies
termination conditions for playing. For more information on this function, see
DV_TPT, on page 485.
filenamep points to the name of the file to play
mode specifies the play mode. The following two symbolic values can be used
individually or ORed together:
• PM_TONE – play 200 msec audible tone
• EV_SYNC – synchronous operation (must be specified)