HMP Linux 1.2 Release Update, Rev 05 — September 2006September 2006 35
Description
The dx_mreciottdata() function records voice data from two TDM bus time slots. The data may
be recorded to a combination of data files, memory or custom devices.
This function is used for the transaction record feature, which allows you to record two TDM bus
time slots from a single channel. Voice activity on two channels can be summed and stored in a
single file, device, and/or memory.
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.
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 DC_XPB.
All files recorded will have the same data encoding and rate as DC_XPB.
Mode: asynchronous or synchronous
Parameter Description
devd specifies the valid channel device handle on which the recording is to occur.
The channel descriptor may be that associated with either of the two TDM bus
transmit time slots or a third device also connected to the TDM bus.
iotp points to the I/O Transfer Table Structure, DX_IOTT, which specifies the
order of recording and the location of voice data. For more information on this
structure, see the DX_IOTT data structure.
tptp points to the Termination Parameter Table Structure, DV_TPT, which
specifies the termination conditions for recording. For more information on
this structure, see the DV_TPT data structure.
xpb points to a DX_XPB structure, which specifies the file format, data format,
sampling rate, and resolution for I/O data transfer. For more information on
this structure, see the DX_XPB data structure.
mode specifies the attributes of the recording mode. One or more of the following
values can be specified:
0 – standard record mode
RM_TONE – transmit a 200 msec tone before initiating record
sc_tsinfop points to the SC_TSINFO data structure and specifies the TDM bus transmit
time slot values of the two time slots being recorded.
In the SC_TSINFO structure, 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 TDM bus transmit time slots from which to record.