Filter
Top Products
cc_Open( ) opens a device
176
Name:
int cc_Open(linedevp, devicename, rfu)
Inputs:
LINEDEV *linedevp
• pointer to the buffer storing the
line device handle
char *devicename
• name of the device
int rfu
• reserved for future use
Returns:
0 on success
<0 on failure
Includes:
cclib.h
Category:
Call control
Mode:
synchronous
Technology:
BRI/2; BRI/SC; PRI (all protocols)
!
! !
!
Description
The cc_Open( ) function opens a device and returns a unique line device handle
to identify the physical device that carries the call. The cc_Open( ) function is
used to open both network board and channel (that is, time slot) devices. Once a
device is opened, all subsequent references to the opened device must be made
using the line device number that is returned to and placed in linedevp.
NOTE:
A channel cannot be opened twice in the same process.
Parameter Description
linedevp: A unique number placed in the location pointed to by linedev.
The number identifies the specific device opened by this
function.
devicename:
The pointer to the ASCII string that defines the device or
devices that will be associated with the returned line device.
The format for devicename is as follows:
PRI:
• dtiBx for board
• dtiBxTy for time
slot
BRI:
• briSx for board
• briSxTy for time
slot
rfu: Reserved for future use. Set rfu to 0.
Each PRI structure is composed of one D channel and 23 (T1) or 30 (E1) B
(bearer) channels. A PRI board device, such as dtiB1, is defined as a station and
controls the D channel. A PRI time slot device, such dtiB1T1, is defined as a
bearer channel under a station.