Filter
Top Products
388 Voice API for Windows Operating Systems Library Reference — November 2003
dx_setparm( ) — set physical parameters of a channel or board device
dx_setparm( )
set physical parameters of a channel or board device
!
!!
! Description
The dx_setparm( ) function sets physical parameters of a channel or board device, such as
off-hook delay, length of a pause, and flash character. You can set only one parameter at a time.
A different set of parameters is available for board and channel devices. Board parameters affect all
channels on the board. Channel parameters affect the specified channel only.
The channel must be idle (that is, no I/O function running) when calling dx_setparm( ).
Name: int dx_setparm(dev, parm, valuep)
Inputs: int dev
• valid channel or board device handle
unsigned long parm
• parameter type to set
void *valuep
• pointer to parameter value
Returns: 0 if successful
-1 if failure
Includes: srllib.h
dxxxlib.h
Category: Configuration
Mode: synchronous
Platform: DM3, Springware
Parameter Description
dev Specifies the valid channel or board device handle obtained when the channel
or board was opened using dx_open( ).
parm Specifies the channel or board parameter to set. The voice device parameters
allow you to query and control device-level information and settings related to
the voice functionality.
For DM3 boards, board parameter defines are described in Table 12. For
Springware boards, board parameter defines are described in Table 13.
For DM3 boards, channel parameter defines are described in Table 14. For
Springware boards, channel parameter defines are described in Table 15.
Note: The parameters set in parm will remain valid after the device has been
closed and reopened.
valuep Points to the 4-byte variable that specifies the channel or board parameter to
set.
Note: You must use a void * cast on the address of the parameter being sent to
the driver in valuep as shown in the Example section.