dx_recvox( )

Description | Cautions | Example | Errors | See Also

Name:	SHORT dx_recvox(chdev, filenamep, tptp, xpbp, mode)
Inputs:	int chdev	valid Dialogic channel device handle
	char *filenamep	pointer to name of file to record to
	DV_TPT *tptp	pointer to Termination Parameter Table
	DX_XPB *xpbp	pointer to I/O Transfer Parameter Block
	unsigned short mode	record mode
Returns:	0 if successful
	-1 if failure
Includes:	srllib.h
	dxxxlib.h
Category:	Convenience function
Mode:	synchronous

Description

The dx_recvox( ) convenience function records voice data to a single VOX file. If xpbp is set to NULL, it will interpret the data as 6KHz linear ADPCM.

Parameter	Description
chdev	Channel device descriptor
tcbp	Pointer to Termination Parameter Table
filenamep	Pointer to name of file to record to
xpbp	Pointer to I/O Transfer Parameter Block. Refer to the DX_XPB structure in the chapter on Data Structures for more information.
mode	specifies the record mode: RM_TONE: play an audible tone before initiating record (pre-record beep) EV_SYNC: synchronous operation (must be specified)
NOTE: Both RM_TONE and EV_SYNC can be specified by ORing the two values.

Cautions

When playing or recording VOX files, the data format is specified in DX_XPB rather than through the mode parameter of dx_recvox( ).

Example

#include "srllib.h"  
#include "dxxxlib.h"
  
int chdev;                  /* channel descriptor */  
DV_TPT tpt;                 /* termination parameter table */  
DX_XPB xpb;                 /* I/O transfer parameter block */  
.  
.  
.  
/* 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);  
}  
/* clear digit buffer */  
dx_clrdigbuf(chdev);  
/* Start 6KHz ADPCM recording */  
if (dx_recvox(chdev,"MESSAGE.VOX", &tpt, NULL,PM_TONE|EV_SYNC) == -1) {  
      printf("Error recording 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_SH_BADCMD	Unsupported command or VOX file format

See Also

• dx_reciottdata( )
• dx_recwav( )

Click here to contact Dialogic Customer Engineering