Intel 05-1832-002 User Manual

388

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( ). 

int dx_setparm(dev, parm, valuep)

int dev

valid channel or board device handle

unsigned long parm

parameter type to set

void *valuep

pointer to parameter value

0 if successful
-1 if failure

srllib.h
dxxxlib.h

Configuration

synchronous

DM3, Springware 

dev 

Specifies the valid channel or board device handle obtained when the channel 
or board was opened using 

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.