Справочник Пользователя для Dialogic 05-0867-005
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
< 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.
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 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.
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.
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.
protocol.