Voice API for Windows Operating Systems Library Reference — November 2003 287
record voice data from two TDM bus time slots — dx_mreciottdata( )
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 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.
• 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.
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 DX_IOTT, on page 509.
tptp points to the Termination Parameter Table Structure, DV_TPT, which
specifies the termination conditions for recording. For more information on
this structure, see DV_TPT, on page 485.
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 DX_XPB, on page 520.
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 200 msec tone before initiating record. If this
mode is not selected, no tone is transmitted (default).
sc_tsinfop points to the SC_TSINFO 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.