1.7.5. Retrieve the CES and SAPI (BRI Only)

The GCIS_EXID_GETENDPOINT extension ID is supported when using Springware boards only. When using DM3 boards, the GCIS_EXID_GETENDPOINT extension ID is not supported.

The GCIS_EXID_GETENDPOINT extension ID is used to retrieve the connection endpoint suffix (CES) and service access point ID (SAPI) associated with a GCEV_D_CHAN_STATUS event. The CES specifies the telephone equipment associated with the station. Currently, for BRI, eight IDs (1 - 8) are supported when used as a network-side terminal. When used as a station-side terminal, only one ID (which must have a value of 1) is supported.

The following table provides the parameter inputs for the GCIS_EXID_GETENDPOINT extension ID.

Parameter	Input
target_type	GCTGT_GCLIB_CHAN
target_id	line device handle (linedev) of the device
ext_id	GCIS_EXID_GETENDPOINT
parmblkp	set_id - GCIS_SET_GENERIC
	parm_id - GCIS_PARM_EVENTDATAP
	value - evtdatap member of METAEVENT structure
	value_type - void *
retblkp	set_id - GCIS_SET_DLINK
	parm_id - GCIS_PARM_DLINK_CES
	values - 1-8 for BRI when used as a network-side terminal.
	value_type - char
	parm_id - GCIS_PARM_DLINK_SAPI
	values - 0 for BRI 16 for X.25 packets over D-channel
	value_type - char
mode	EV_SYNC

The GCIS_EXID_GETENDPOINT extension ID applies only to BRI protocols and is not supported for BRI/2 board.

Example

int extGetEndPoint (LINEDEV handle, void *evtdatap)
{
    GC_PARM_DATAP parm_datap;
    GC_PARM_BLKP parm_blkp = NULL, ret_blkp = NULL;
    unsigned long mode;
    int ret_val = 0;
    GC_INFO  t_Info;
    
    gc_util_insert_parm_ref( &parm_blkp, GCIS_SET_GENERIC, GCIS_PARM_EVENTDATAP,
         sizeof( void * ), evtdatap); 
    mode = EV_SYNC; 
    ret_val = gc_Extension(GCTGT_GCLIB_CHAN, handle, GCIS_EXID_GETENDPOINT,
           parm_blkp, &ret_blkp, mode); 
    if ( ret_val )
    {
           ret_val = gc_ErrorInfo(&t_Info);
           if (ret_val == GC_SUCCESS) {
                    printf("gc_ErrorInfo() successfully called\n");
                    PrintGC_INFO(&t_Info);
           }
    }
    gc_util_delete_parm_blk( parm_blkp );
    gc_util_delete_parm_blk( ret_blkp );
    return ret_val;
} 

Click here to contact Telecom Support Resources