cc_SetMinDigits( )

Description | Cautions | Example | Errors | See Also

Name:	int cc_SetMinDigits(linedev, mindigits)
Inputs:	LINEDEV linedev	device handle
	int mindigits	the minimum number of digits to be collected
Returns:	0 on success < 0 on failure
Includes:	cclib.h
Category:	Optional call handling
Mode:	synchronous
Technology:	BRI/2; BRI/SC; PRI (all protocols)

Description

The cc_SetMinDigits( ) function sets the minimum number of digits to be collected prior to receiving a CCEV_OFFERED event, in asynchronous mode, or prior to executing the cc_WaitCall( ) function, in synchronous mode. For example, if the minimum number of digits is set to 10, the firmware will not generate CCEV_OFFERED or the cc_WaitCall( ) function will not complete until at least 10 digits are collected.

Parameter	Description
linedev:	The line device handle or, for applications using the call waiting feature, the board device handle (BRI and Windows only).
mindigits:	Specifies the minimum number of digits to be collected prior to receiving a CCEV_OFFERED event (asynchronous) or prior to executing the cc_WaitCall( ) function (synchronous).

Cautions

Using cc_SetMinDigits( ) on a board device will overwrite any prior setting used on an individual channel device belonging to that board.

Example

NOTE:

See the code sample in the cc_MakeCall( ) function description for an example of how to use the cc_SetMinDigits( ) function with the call waiting feature (BRI and Windows only).

#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";  
   char      dnis_buf[CC_ADDRSIZE];  
   if ( cc_Open( &devhdl, devname, 0 ) < 0 )   
   {  
      printf("Error opening device: errno = %d\n", errno);  
      exit(1);  
   }  
  /*   
   * using cc_SetMinDigits(linedev, mindigits) to set minimum  
   * digits to be collected before terminating the WaitCall().  
   * Only needed when overlap receiving is needed.  
   */   
   if ( cc_SetMinDigits(linedev, mindigits) < 0 )  
        procdevfail(devhdl);  
   if ( cc_WaitCall(devhdl, &crn, NULL, -1, EV_SYNC) < 0 )  
        procdevfail(devhdl);  
   printf("Retrieving DNIS\n");  
   if ( cc_GetDNIS(crn,dnis_buf) < 0 )  
        callfail(crn);  
   else  
        printf("cc_GetDNIS succeeded: %s\n",dnis_buf);  
   if ( cc_AnswerCall(crn, 0, EV_SYNC) < 0 )  
        callfail(crn);  
   /* Voice process after this. */  
        .  
        .  
        .  
        .  
        .  
   /* Drop the call */  
   if ( cc_DropCall(crn, NORMAL_CLEARING, EV_SYNC) < 0 )  
        callfail(crn);  
   if ( cc_ReleaseCall(crn) < 0 )  
        callfail(crn);  
   /* Close the device */  
   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 a value < 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_SetMinDigits( ) function include the following:

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

See Also

• cc_WaitCall( )
• cc_MakeCall( )

Click here to contact Dialogic Customer Engineering