Intel 05-1832-002 IP Phone User Manual


 
Voice API for Windows Operating Systems Library Reference — November 2003 351
record voice data to a single VOX file — dx_recvox( )
dx_recvox( )
record voice data to a single VOX file
!
!!
! Description
The dx_recvox( ) function records voice data from a channel to a single VOX file. This is a
convenience function.
!
!!
! Cautions
On DM3 boards using a flexible routing configuration, voice channels must be listening to a
TDM bus time slot in order for any voice streaming functions, such as dx_rec( ), to work. In
Name: SHORT dx_recvox(chdev, filenamep, tptp, xpbp, mode)
Inputs: int chdev
valid channel device handle
char *filenamep
pointer to name of file to record to
DV_TPT *tptp
pointer to Termination Parameter Table structure
DX_XPB *xpbp
pointer to I/O Transfer Parameter Block structure
unsigned short mode
record mode
Returns: 0 if successful
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: I/O Convenience
Mode: synchronous
Platform: DM3, Springware
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was
opened using dx_open( )
filenamep points to the name of the VOX file to record to
tptp points to the Termination Parameter Table Structure, DV_TPT, which
specifies termination conditions for recording. For more information on this
structure, see DV_TPT, on page 485.
xpbp points to the I/O Transfer Parameter Block structure, which specifies the file
format, data format, sampling rate, and resolution of the voice data. For more
information, see DX_XPB, on page 520.
Note: If xpbp is set to NULL, this function interprets the data as 6 kHz linear
ADPCM.
mode specifies the record mode. The following two values must be ORed together:
PM_TONE – play 200 msec audible tone
EV_SYNC – synchronous operation (must be specified)