ms_unmonconf( )

---

Cautions | Errors | Example | See Also

Name:	int ms_unmonconf (devh, confID)
Inputs:	int devh	MSI board device handle
	int confID	conference ID
Returns:	0 on success -1 on failure (if the board is NOT an MSI board)
Includes:	srllib.h dtilib.h msilib.h
Category:	Conference Management
Mode:	synchronous
Platform:	DI, Springware

Description

Note: This function is not supported on Intel® NetStructure™ High Density Station Interface (HDSI) boards, however, it is supported on Intel® Dialogic® Integrated Series boards.

The ms_unmonconf( ) function removes a monitor from a conference. Calling this function frees one resource.

Parameter	Description
devh	the MSI board device handle
confID	the conference identifier

Cautions

This function fails when:

• The device handle specified is invalid
• It is called for a non-MSI board
• An invalid conference is specified
• A monitor does not exist in the conference

Errors

If this function returns -1 to indicate failure, obtain the reason for the error by calling the SRL standard attribute function ATDV_LASTERR( ) or ATDV_ERRMSGP( ) to retrieve either the error code or a pointer to the error description, respectively.

Refer to the error type tables found in Chapter 5, "Error Codes". Error defines can be found in dtilib.h or msilib.h.

Example

#include <windows.h>           /* For Windows applications only */
#include <errno.h>
#include "srllib.h"
#include "dtilib.h"
#include "msilib.h"  
#define  NUM_PARTIES  2  
int  dev1;                     /* Board dev descriptor variables */
int  tsdev1;                   /* DTI time slot device handle */
MS_CDT cdt[NUM_PARTIES];       /* conference descriptor table */
int  confID;                   /* conference ID */
long  lts;                     /* listen time slot */
SC_TSINFO       tsinfo;        /* time slot information structure */  
/* Open board 1 device */
if ((dev1 = ms_open("msiB1",0)) == -1) {
    printf( "Cannot open MSI B1: errno=%d", errno);
    exit(1);
}  
/* Assume that there is a DTI in the system.
 * Assume the device handle for a time slot on the DTI
 * is tsdev1 and time slot it is assigned to is ts1
*/  
/* Set up CDT structure */
cdt[0].chan_num = station ;     /* Valid MSI Station */
cdt[0].chan_sel = MSPN_STATION;
cdt[0].chan_attr = MSPA_NULL;  
cdt[1].chan_num = ts1 ;      /*  ts1 is the DTI time slot */
cdt[1].chan_sel = MSPN_TS;
cdt[1].chan_attr = MSPA_RO;  
/* Establish conference */
if (ms_estconf(dev1, cdt, NUM_PARTIES, MSCA_ND, &confID) == -1) {
    printf("Error Message = %s",ATDV_ERRMSGP(dev1));
    exit(1);
}  
/*
 * Continue Processing
 */  
/* Now monitor the conference */
if (ms_monconf(devh,confID,&lts)== -1) {
    printf("Error Message = %s",ATDV_ERRMSGP(dev1));
    exit(1);
}  
/* Assume that a DTI time slot  tsdev1 is the available  */
tsinfo.sc_numts = 1;
tsinfo.sc_tsarray = &lts;  
if (dt_listen(tsdev1,&tsinfo) == -1){
    printf("Error Message = %s",ATDV_ERRMSGP(tsdev1));
    exit(1);
}
/*
 * Continue processing
 */  
/* Unlisten to the monitor's time slot first */
if (dt_unlisten(tsdev1) == -1) {
    printf("Error message = %s\n", ATDV_ERRMSGP(tsdev1);
    exit(1);
}  
/* Now unmonitor the conference */
if (ms_unmonconf(devh, confID) == -1) {
    printf("Error message = %s\n", ATDV_ERRMSGP(devh));
    exit(1);
}  
/* Continue processing */  

See Also

• ms_estconf( )
• ms_monconf( )

Click here to contact Telecom Support Resources