cc_AcceptCall( )

Description | Termination Events | Cautions | Example | Errors | See Also

Name:	int cc_AcceptCall(crn, rings, mode)
Inputs:	CRN crn	call reference number
	int rings	number of rings before return
	unsigned long mode	synchronous or asynchronous
Returns:	0 on success < 0 on failure
Includes:	cclib.h
Category:	Optional call handling
Mode:	synchronous or asynchronous
Technology:	BRI/2; BRI/SC; PRI (all protocols)

Description

The cc_AcceptCall( ) function responds to an incoming call request. A CCEV_OFFERED event on the completion of cc_WaitCall( ) signifies an incoming call request. The cc_AcceptCall( ) function sends an ALERTING message to the network to indicate that the destination is ringing and to stop the network from sending any further information. The ALERTING message also stops the protocol layer 3 timer under fast connect. After the successful completion of the cc_AcceptCall( ) function, the call state changes from Offered to Accepted.

This command is not required in most applications if the application can respond within the protocol timeout restriction.

Parameter	Description
crn:	The call reference number. Each call needs a CRN.
rings:	Specifies how long the protocol handler will wait before returning to the calling entity. The rings parameter is not used for ISDN and will be ignored. Set rings to 0.
mode:	Specifies asynchronous (EV_ASYNC) or synchronous (EV_SYNC) mode.

Termination Events

• CCEV_ACCEPT - indicates that an ALERTING message has been sent to the network.
• CCEV_TASKFAIL - indicates that a request/message was rejected by the firmware. Typically, this event is triggered by an incorrect function call during the call.

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"  
void main()  
{  
   LINEDEV   devhdl    = 0;  
   CRN       crn = 0;  
   char     *devname = "dtiB1T1";  
   if ( cc_Open( &devhdl, devname, 0 ) < 0 )   
   {  
      printf("Error opening device: errno = %d\n", errno);  
      exit(1);  
   }  
   printf("Waiting for call\n");  
   if ( cc_WaitCall(devhdl, &crn, NULL, -1, EV_SYNC) < 0 )  
        procdevfail(devhdl);  
   printf("Accepting call\n");  
   if ( cc_AcceptCall(crn, 0, EV_SYNC) < 0 )  
        callfail(crn);  
   if ( cc_AnswerCall(crn, 0, EV_SYNC) < 0 )  
        callfail(crn);  
      .  
      .  
      .  
      .  
      .  
   /* Drop the call */  
   if ( cc_DropCall(crn, NORMAL_CLEARING, EV_SYNC) < 0 )  
        callfail(crn);  
   if ( cc_ReleaseCall(crn) < 0 )  
        callfail(crn);  
   if ( cc_Close( devhdl ) < 0 )   
      printf("Error closing device, errno = %d\n", errno);  
}  
int callfail(CRN crn)  
{                 
        LINEDEV ld;  
        cc_CRN2LineDev(crn,&ld);  
        procdevfail(ld);  
}  
int procdevfail(LINEDEV handle)  
{  
        int reason;  
        char *msg;  
        reason = cc_CauseValue(handle);  
        cc_ResultMsg(handle,reason,&msg);  
        printf("reason = %x - %s\n",reason,msg);  
}

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_AcceptCall( ) function include the following:

Error Code	Description
ERR_ISDN_LIB | E_ISBADIF	Bad interface number
ERR_ISDN_LIB | E_ISBADCALLID	Bad call identifier
ERR_ISDN_LIB | E_ISBADTS	Bad time slot

See Also

• cc_WaitCall( )
• cc_AnswerCall( )

Click here to contact Dialogic Customer Engineering