dx_playwav( )

Description | Cautions | Example | Errors | See Also

Name:	SHORT dx_playwav(chdev, filenamep, tptp, mode)
Inputs:	int chdev	valid Dialogic channel device handle
	char *filenamep	pointer to name of file to play
	DV_TPT *tptp	pointer to termination parameter block
	unsigned short mode	play mode
Returns:	0 if successful
	-1 if failure
Includes:	srllib.h
	dxxxlib.h
Category:	Convenience function
Mode:	synchronous

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.

Parameter	Description
chdev	Channel device descriptor
tcbp	Pointer to termination parameter table
filenamep	Pointer to name of file to play
mode	specifies the play mode: PM_TONE play 200 ms audible tone EV_SYNC synchronous operation (must be specified) NOTE: Both PM_TONE and EV_SYNC can be specified by ORing the two values.

Cautions

This function fails when an unsupported data waveform attempts to play. The supported waveforms are:

• 6, 8, and 11KHz linear 8-bit PCM (WAVE_FORMAT_PCM)
• 6, 8, and 11KHz mu-law 8-bit PCM (WAVE_FORMAT_MULAW)
• 6, 8, and 11KHz a-law 8-bit PCM (WAVE_FORMAT_ALAW)
• 6 and 8KHz 4-bit Oki ADPCM (WAVE_FORMAT_DIALOGIC_OKI_ADPCM)

Example

#include "srllib.h"  
#include "dxxxlib.h"
  
int chdev;        /* channel descriptor */  
DV_TPT tpt;        /* termination parameter table */  
.  
.  
.
  
/* Open channel */  
if ((chdev = dx_open("dxxxB1C1",0)) == -1) {  
      printf("Cannot open channel\n");  
      /* Perform system error processing */  
      exit(1);  
}  
/* Set to terminate play on 1 digit */  
tpt.tp_type   = IO_EOT;  
tpt.tp_termno = DX_MAXDTMF;  
tpt.tp_length = 1;  
tpt.tp_flags  = TF_MAXDTMF;  
/* Wait forever for phone to ring and go offhook */  
if (dx_wtring(chdev,1,DX_OFFHOOK,-1) == -1) {  
      printf("Error waiting for ring - %s\n",     ATDV_LASTERR(chdev));  
      exit(3);  
}  
/* Start playback */  
if (dx_playwav(chdev,"HELLO.WAV",&tpt,EV_SYNC) == -1) {  
      printf("Error playing file - %s\n",        ATDV_ERRMSGP(chdev));  
      exit(4);  
}

Errors

If this function returns -1 to indicate failure, one of the following reasons will be contained by ATDV_LASTERR( ):

Equate	Returned When
EDX_BUSY	Channel is busy
EDX_XPBPARM	Invalid DX_XPB setting
EDX_BADIOTT	Invalid DX_IOTT setting
EDX_SYSTEM	Error from operating system; use dx_fileerrno( ) to obtain error value. System I/O errors
EDX_BADWAVFILE	Invalid WAV file
EDX_SH_BADCMD	Unsupported command or WAV file format

See Also

• dx_playiottdata( )
• dx_playvox( )

Click here to contact Dialogic Customer Engineering