dx_mreciottdata( )

Description | Cautions | Example | Errors | See Also

Name:	dx_mreciottdata (devd, iotp, tptp, xpb, mode, sc_tsinfop)
Inputs:	int devd	Dialogic channel descriptor
	DX_IOTT *iotp	Pointer to I/O transfer table
	DV_TPT *tptp	Pointer to termination control block
	DX_XPB *xpb	Pointer to I/O transfer parameter block
	USHORT *mode	Switch to set audible tone, or DTMF termination
	*sc_tsinfop	Pointer to time slot information structure
Returns:	0 success
	-1 error return code
Includes:	srllib.h
	dxxxlib.h
Category:	I/O
Mode:	synchronous

Description

The dx_mreciottdata( ) function records voice data from two SCbus time slots. The data may be recorded to a combination of data files, memory or custom devices.

The Transaction Record feature allows you to record two SCbus time slots from a single channel. Voice activity on two channels can be summed and stored in a single file, device, and/or memory.

This function has the following parameters:

Parameter	Description
devd	Specifies the valid Dialogic voice channel descriptor on which the recording is to occur. The channel descriptor may be that associated with either of the two SCbus transmit time slots or a third device also connected to the SCbus.
iotp	Pointer to the I/O Transfer Table Structure, DX_IOTT. Specifies the order of the voice data and the media on which it will be recorded.
tptp	Points to the Termination Parameter Table Structure, DV_TPT, which specifies the termination conditions for recording. See the chapter on Data Structures for more information.
xpb	Points to a DX_XPB structure and specifies parameter values for I/O data transfer. See the chapter on Data Structures for more information.
mode	Specifies the attributes of the recording mode. One or more of the following values can be specified:
	0	standard play mode
	RM_TONE	Transmits a 200ms tone before initiating record. If this mode is not selected, no tone is transmitted (default).
sc_tsinfop	Points to an SC_TSINFO structure and specifies the SCbus transmit time slot values of the two time slots being recorded.

NOTE:

When using RM_TONE bit for tone-initiated record, each time slot must be "listening" to the transmit time slot of the recording channel; the alert tone can only be transmitted on the recording channel's transmit time slot.

The structure for SC_TSINFO is as follows:

     typedef struct {  
              unsigned long      sc_numts:      /* Number of time slots in array */  
              long              *sc_tsarrayp:   /* Pointer to array of SCbus time slots */  
     }SC_TSINFO;

where sc_numts should be set to 2 for channel recording and sc_tsarrayp should point to an array of two long integers, specifying the two SCbus transmit time slots from which to record.

After dx_mreciottdata( ) is called, recording continues until one of the following occurs:

• dx_stopch( ) is called on the channel whose device handle is specified in the devd parameter
• the data requirements specified in the DX_IOTT structure are fulfilled
• one of the conditions for termination specified in the DV_TPT structure is satisfied

Cautions

• All files specified in the DX_IOTT structure are of the file format specified in DX_XPB.
• All files recorded will have the same data encoding and rate as DX_XPB.
• When recording VOX files, the data format is specified in DX_XPB rather than through the dx_setparm( ) function.
• Voice data files that are specified in the DX_IOTT structure must be opened with the O_BINARY flag.
• The DX_IOTT data area must remain in scope for the duration of the function if running asynchronously.
• The DX_XPB data area must remain in scope for the duration of the function if running asynchronously.
• When using MSI/SC stations for Transaction Recording, make sure a full duplex connection is established. You must issue an ms_listen( ) even though the MSI/SC station is used only for transmitting.
• Because the DSP sums the PCM values of the two SCbus time slots before processing them during transaction recording, all voice-related terminating conditions or features such as DTMF detection, Automatic Gain Gontrol (AGC), and sample rate change will apply to both time slots. In other words, for terminating conditions specified by a DTMF digit, either time slot containing the DTMF digit will stop the recording. Also, maximum silence length requires simultaneous silence from both time slots to meet the specification.
• If both time slots transmit a DTMF digit at the same time, the recording will contain an unintelligible result.
• The Transaction Record feature may not detect a DTMF digit over a dial tone.
• Since this application programming interface (API) uses dx_listen( ) to connect the channel to the first specified time slot, any error returned from dx_listen( ) will terminate the API with the error indicated.
• The API will connect the channel to the time slot specified in sc_tsarrayp[0] and remain connected after the function has been completed. Both sc_tsarrayp[0] and sc_tsarrayp[1] must be within the range 0 to 1023. No checking is done to verify that sc_tsarrayp[0] or sc_tsarrayp[1] has been connected to a valid channel.
• Upon termination of the dx_mreciottdata( ) function, the recording channel continues to listen to the first time slot (pointed to by sc_tsarray[0]).
• The application should check for a TDX_RECORD event with T_STOP event data after executing a dx_stopch( ) function during normal and transaction recording. This will ensure that all data is written to the disk.
• The recording channel can only detect a loop current drop on a physical analog front end that is associated with that channel. If you have a configuration where the recording channel is not listening to its corresponding front end, you will have to design the application to detect the loop current drop and issue a dx_stopch( ) to the recording device. The recording channel hook state should be off-hook while the recording is in progress.

Example

#include <windows.h>  
#include <fcntl.h>  
#include <stdio.h>  
#include <stdlib.h>  
#include <srllib.h>  
#include <dxxxlib.h>
  
#define MAXLEN 10000  
main()  
{  
  int devh1, devh2, devh3;  
  short fd;  
  DV_TPT tpt;  
  DX_IOTT iott[2];  
  DX_XPB xpb;  
  SC_TSINFO tsinfo;  
  long scts;  
  long tslots[32];  
  char basebufp[MAXLEN];  
  /* open two voice channels */
  
  if ((devh1 = dx_open("dxxxB1C1", NULL)) == -1) {  
      printf("Could not open dxxxB1C1\n");  
      exit (1);  
}  
  if ((devh2 = dx_open("dxxxB1C2", NULL)) == -1) {  
      printf("Could not open dxxxB1C2\n");  
      exit (1);  
}  
  if ((devh3 = dx_open("dxxxB1C3", NULL)) == -1) {  
      printf("Could not open dxxxB1C2\n");  
      exit (1);  
}  
  if ((fd = dx_fileopen("file.vox", O_CREAT | O_RDWR | O_BINARY)) == -1){  
      printf("File open error\n");  
      exit (1);  
  }  
  /*  
   * Get channels' external time slots  
   * and fill in tslots[] array  
   */  
  tsinfo.sc_numts = 1;  
  tsinfo.sc_tsarrayp = &scts;  
  if (dx_getxmitslot (devh1, &tsinfo) == -1 ){ /* Handle error */ }  
    
  tslots[0] = scts;  
  if (dx_getxmitslot (devh2, &tsinfo) == -1 ) { /* Handle error */ }  
  tslots[1] = scts;  
  /* Set up SC_TSINFO structure */  
  tsinfo.sc_numts = 2;  
  tsinfo.sc_tsarrayp = &tslots[0];  
  /* Set up DX_XPB structure */  
  xpb.wFileFormat = FILE_FORMAT_VOX;  
  xpb.wDataFormat = 0;  
  xpb.nSamplesPerSec = 0L;  
  xpb.wBitsPerSample = 0;  
  /*Set up DV_TPT structure */  
  dx_clrtpt (&tpt,1);  
  tpt.tp_type = IO_EOT;  
  tpt.tp_termno = DX_MAXDTMF;  
  tpt.tp_length = 1;  
  tpt.tp_flags = TF_MAXDTMF;  
  /* Set up DX_IOTT structure */  
  iott[0].io_fhandle = fd;  
  iott[0].io_type = IO_DEV;  
  iott[0].io_offset = 0;  
  iott[0].io_length = MAXLEN;  
  iott[0].io_offset = IO_EOT;  
  /* And record from both voice channels */  
  if (dx_mreciottdata(devh3, &iott[0], &tpt, &xpb, RM_TONE, &tsinfo) == -1) {  
     printf("Error recording from dxxxB1C1 and dxxxB1C2\n");  
     printf("error = %s\n", ATDV_ERRMSGP(devh1));  
     exit(2);  
  }  
  /* Display termination condition value */  
  printf ("The termination value = %d\n", ATDX_TERMMSK(devh1));  
  /* And close three voice channels */  
  if (dx_close(devh3) == -1){  
     printf("Error closing devh3 \n");  
     /* Perform system error processing */  
     exit(3);  
}  
  if (dx_close(devh2) == -1) {  
     printf("Error closing devh2\n");  
     /* Perform system error processing */  
     exit (3);  
  }  
  if (dx_close(devh1) == -1) {  
     printf("Error closing devh1\n");  
     /* Perform system error processing */  
     exit (3);  
  }  
  if (dx_fileclose(fd) == -1){  
     printf("File close error \n");  
     exit(1);  
  }  
 /* And finish */  
   return;  
}

Errors

If this function returns -1 to indicate failure, use ATDV_LASTERR and ATDV_ERRMSGP to retrieve one of the following error reasons:

EDX_BADDEV	Invalid device handle
EDX_BADIOTT	Invalid DX_IOTT entry
EDX_BADPARM	Invalid parameter passed
EDX_BADTPT	Invalid DV_TPT entry
EDX_BUSY	Busy executing I/O function
EDX_SYSTEM	Error from operating system; use dx_fileerrno( ) to obtain error value

See Also

• dx_rec( )
• dx_play( )
• dx_reciottdata( )
• dx_playiottdata( )

Click here to contact Dialogic Customer Engineering