cc_SetDLinkCfg( )

Description | Cautions | Example | Errors | See Also

Name:	int cc_SetDLinkCfg(bdev, dlinkptr, dlinkcfgptr)
Inputs:	LINEDEV bdev	device handle
	DLINK *dlinkptr	pointer to data link information block
	DLINK_CFG *dlinkcfgptr	pointer to location of D channel logical link configuration block
Returns:	0 on success < 0 on failure
Includes:	cclib.h
Category:	System tools
Mode:	synchronous
Technology:	BRI/SC

Description

The cc_SetDLinkCfg( ) function configures a logical link. This function initializes the required firmware structures to allow the logical link to be used.

Parameter	Description
bdev:	Station device handle.
dlinkptr:	Pointer to the data link information block. See Section 6.4. DLINK for a description of the elements of this data structure.
dlinkcfgptr:	Pointer to the buffer containing the data link logical link configuration block. See Section 6.5. DLINK_CFG for a description of the elements of this data structure.

Cautions

None

Example

#include <windows.h>   /* For Windows applications only */  
#include <stdio.h>  
#include <errno.h>  
#include "srllib.h"  
#include "dtilib.h"  
#include "cclib.h"  
/* Global variables */  
LINEDEV      ldev;   /* Board device handle */  
main()  
{  
   DLINK dlink;  
   DLINK_CFG cfg;  
   .  
   .  
   .  
   dlink.sapi = 0;  
   dlink.ces = 1;   
   cfg.tei = AUTO_TEI;  
   cfg.state = DATA_LINK_UP;  
   cfg.protocol = DATA_LINK_PROTOCOL_Q931;   
   if ( cc_SetDLinkCfg(ldev, &dlink, &cfg) < 0) {  
      printf("error");  
   } else {  
       .  
       .  
       .  
   }  
}

Errors

If the function returns < 0 to indicate failure, use the cc_CauseValue( ) function to retrieve the reason code for the failure. The cc_ResultMsg( ) function can be used to interpret the reason code. Error codes are defined in the files ccerr.h, isdnerr.h, and isdncmd.h.

Error codes from the cc_SetDLinkCfg( ) function include the following:

Error Code	Description
E_BADDEV | ERR_ISDN_LIB	Bad Device Descriptor
E_INVNDIINTERFACE | ERR_ISDN_LIB	Invalid NDI Interface
E_INVNRB | ERR_ISDN_LIB	Invalid NRB

See Also

• cc_GetDLinkCfg( )

Click here to contact Dialogic Customer Engineering