Dialogic 05-0867-005 Table Top Game User Manual


 
retrieves the frame cc_GetFrame( )
119
Name:
int cc_GetFrame(linedev, rcvfrmptr)
Inputs:
LINEDEV linedev
line device handle for D channel
L2_BLK *rcvfrmptr
pointer to the received frame buffer
Returns:
0 on success
< 0 on failure
Includes:
cclib.h
Category:
Data link layer handling
Mode:
synchronous
Technology:
BRI/SC; PRI (excluding DPNSS)
!
! !
!
Description
The cc_GetFrame( ) function retrieves the frame received by the application.
This function is used after a CCEV_L2FRAME event is received. Each
CCEV_L2FRAME event is associated with one frame. This function is used for
the data link layer only.
To enable Layer 2 access, set parameter number 24 to 01 in the firmware
parameter file. When Layer 2 access is enabled, only the cc_GetFrame( ) and
cc_SndFrame( ) functions can be used ( no calls can be made).
Parameter Description
linedev:
The line device handle for the D channel.
rcvfrmptr:
The pointer to the buffer where the received frame is to be
stored. The L2_BLK data structure contains the retrieved
frame. See Section 6.7. L2_BLK for a description of the data
structure. See the Example code for details.
!
! !
!
Cautions
The cc_GetFrame( ) function is called only after a CCEV_L2FRAME event
is received. Refer to the protocol-specific parameter file.
This function is not supported for the BRI/2 board or for the PRI DPNSS
protocol.