Intel 05-1832-002 IP Phone User Manual


 
Voice API for Windows Operating Systems Library Reference — November 2003 343
record voice data to a single file — dx_recf( )
dx_recf( )
record voice data to a single file
!
!!
! Description
The dx_recf( ) function is a convenience function that records voice data from a channel to a single
file.
Calling dx_recf( ) is the same as calling dx_rec( ) and specifying a single file entry in the
DX_IOTT structure. Using dx_recf( ) is more convenient for recording to one file, because you do
not have to set up a DX_IOTT structure for one file, and the application does not need to open the
file. The dx_recf( ) function opens and closes the file specified by fnamep.
!
!!
! Cautions
None.
Name: int dx_recf(chdev, fnamep, tptp, mode)
Inputs: int chdev
valid channel device handle
char *fnamep
pointer to file to record to
DV_TPT *tptp
pointer to Termination Parameter Table structure
unsigned short mode
recording mode bit mask for this record session
Returns: 0 if success
-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( )
fnamep points to the file from which voice data will be recorded
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.
mode defines the recording mode. One or more of the values listed in the mode
description of dx_rec( ) may be selected in the bitmask using bitwise OR (see
Table 11, “Record Mode Selections”, on page 338 for record mode
combinations).