Dialogic 05-0867-005 Table Top Game User Manual


 
cc_SetInfoElem( ) sets additional information elements
238
Name:
int cc_SetInfoElem(linedev, iep)
Reference:
LINEDEV linedev
line device handle of the B channel
board
Inputs:
IE_BLK *iep
pointer to the information element
buffer
Returns:
0 on success
< 0 on failure
Includes:
cclib.h
Category:
Optional call handling
Mode:
synchronous
Technology:
BRI/2; BRI/SC; PRI (all protocols)
!
! !
!
Description
The cc_SetInfoElem( ) function sets additional information elements, allowing
the application to include application-specific ISDN information elements in the
next outbound message. This function is used for rapid deployment of an
application that “interworks” with the network to take advantage of ISDN's
capabilities. A typical application is user-to-user information elements in each
outgoing message.
NOTE:
See Appendix C for descriptions of ISDN IEs that are specific to the
DPNSS protocol.
Parameter Description
linedev:
The B channel board line device handle.
iep:
The starting address of the information element block (IE_BLK).
For a description of the IE_BLK data structure, see Section
6.6. IE_BLK. See the Example code for details.
!
! !
!
Cautions
This function must be used immediately before calling a function that sends
an ISDN message. The information elements specified by this function are
applicable only to the next outgoing ISDN message.
The line device handle in the parameter must be the same as the one used in
the function call that sends the ISDN message.
The IE data length must not exceed MAXLEN_IEDATA of 254 bytes.