dcb_delconf( )

Description | Cautions | Example | Errors | See Also

Name:	int dcb_delconf(devh, confid)
Inputs:	int devh	DCB/SC DSP device handle
	int confid	conference identifier
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h msilib.h dcblib.h
Category:	Conference Management
Mode:	synchronous

Description

The dcb_delconf( ) function deletes a previously established conference. The conference ID specifies the conference to be deleted.

Parameter	Description
devh:	The DCB/SC DSP device handle.
confid:	The DCB/SC conference identifier.

NOTES:

1. Calling this function frees all resources in use by the conference.

2. Dialogic recommends that the appropriate xx_unlisten( ) function be called for each conferee before dcb_delconf( ) is called.

Cautions

This function fails when:

• The specified device handle is invalid.
• The conference ID is invalid.

Example

#include <windows.h>  
#include <stdio.h>  
#include "srllib.h"  
#include "dtilib.h"  
#include "msilib.h"  
#include "dcblib.h"  
#include "errno.h"  
#define NUM_PARTIES     2  
main()   
{  
   int  dspdevh;			/* DSP device descriptor variable */  
   int  tsdevh1, tsdevh2;		/* Time slot device descriptors */  
   MS_CDT  cdt[NUM_PARTIES];		/* Conference descriptor table */  
   int  confid;			/* Conference ID */  
   SC_TSINFO tsinfo;		/* Time slot information structure */  
   long scts;			/* SCbus time slot */  
   /* Open DCB/SC board 1, DSP 2 device */  
   if ((dspdevh = dcb_open("dcbB1D2",0)) == -1) {  
      printf("Cannot open dcbB1D2 : errno = %d", errno);  
      exit(1);  
   }  
   /* Assume DCB/SC connected to a DTI via SCbus. */  
   /* Open DTI board 1, time slot 1 */  
   if ((tsdevh1 = dt_open("dtiB1T1",0)) == -1) {  
      printf( "Cannot open dtiB1T1: errno = %d", errno);  
      exit(1);  
   }  
   /* Get SCbus transmit time slot of tsdevh1 */  
   if (dt_getxmitslot(tsdevh1, &tsinfo) == -1){  
      printf("Error Message = %s", ATDV_ERRMSGP(tsdevh1));  
      exit(1);  
   }  
   /* Set up CDT structure */     
   cdt[0].chan_num  = (int)scts ;		/* SCbus time slot returned */  
   cdt[0].chan_sel  = MSPN_TS;		/* from dt_getxmitslot() */  
   cdt[0].chan_attr = MSPA_NULL;		/* Conferee has no special attributes */  
   /* Open DTI board 1, time slot 2 */  
   if ((tsdevh2 = dt_open("dtiB1T2",0)) == -1) {  
      printf( "Cannot open dtiB1T2 : errno = %d", errno);    
      exit(1);  
   }  
   /* Get SCbus transmit time slot of tsdevh2 */  
   if (dt_getxmitslot(tsdevh2, &tsinfo) == -1) {  
      printf("Error Message = %s", ATDV_ERRMSGP(tsdevh2));  
      exit(1);  
   }  
   /*  Set up CDT structure */     
   cdt[1].chan_num  = (int)scts;	/* SCbus time slot returned */  
   cdt[1].chan_sel  = MSPN_TS;	/* from dt_getxmitslot() */  
   cdt[1].chan_attr = MSPA_TARIFF;	/* Conferee receives periodic tariff tone */	  
   /* Establish a 2 party conference */  
   if (dcb_estconf(dspdevh, cdt, NUM_PARTIES, MSCA_ND, &confid) == -1) {  
      printf("Error Message = %s", ATDV_ERRMSGP(dspdevh));  
      exit(1);  
   }  
   /* Do a listen for time slot tsdevh1 */  
   tsinfo.sc_numts = 1;  
   tsinfo.sc_tsarrayp = &cdt[0].chan_lts;  
   if (dt_listen(tsdevh1,&tsinfo) == -1) {  
      printf("Error Message = %s", ATDV_ERRMSGP(tsdevh1));  
      exit(1);  
   }  
   
   /* Do a listen for the time slot tsdevh2 */  
   tsinfo.sc_numts = 1;  
   tsinfo.sc_tsarrayp = &cdt[1].chan_lts;  
   if (dt_listen(tsdevh2,&tsinfo) == -1) {  
      printf("Error Message = %s", ATDV_ERRMSGP(tsdevh2));  
      exit(1);  
   }  
   
   /* Continue Processing */  
   /* Unlisten the time slots */  
   if (dt_unlisten(tsdevh1) == -1) {  
      printf("Error Message = %s", ATDV_ERRMSGP(tsdevh1));  
      exit(1);  
   }  
   if (dt_unlisten(tsdevh2) == -1) {  
      printf("Error Message = %s", ATDV_ERRMSGP(tsdevh2));  
      exit(1);  
   }  
   /* Delete the conference */  
   if (dcb_delconf(dspdevh, confid) == -1) {  
      printf("Cannot delete conference %d. Error Message = %s", confid,  
            ATDV_ERRMSGP(dspdevh));  
      exit(1);  
   }  
   else   
      printf("Conference deleted\n");  
   /* Done processing - close all open devices */  
   if(dcb_close(dspdevh) == -1) {  
      printf("Cannot close dcbB1D2 : errno = %d", errno);  
      exit(1);  
   }  
   if(dt_close(tsdevh2) == -1) {  
      printf("Cannot close dtiB1T2 : errno = %d", errno);  
      exit(1);  
   }  
   if(dt_close(tsdevh1) == -1) {  
      printf("Cannot close dtiB1T1 : errno = %d", errno);  
      exit(1);  
   }  
}

Errors

If the function does not complete successfully, it will return -1 to indicate an error. Use the Standard Attribute functions ATDV_LASTERR( ) to obtain the applicable error value, or ATDV_ERRMSGP( ) to obtain a more descriptive error message.

Refer to the error type tables found in Chapter 2 of this guide. Error defines can be found in dtilib.h, msilib.h or dcblib.h.

See Also

• dcb_addtoconf( )
• dcb_estconf( )
• dcb_remfromconf( )

Click here to contact Dialogic Customer Engineering