ms_getcnflist( )

---

Cautions | Errors | Example | See Also

Name:	int ms_getcnflist (devh, confID, numpty, cdt)
Inputs:	int devh	MSI board device handle
	int confID	conference identifier
	int *numpty	pointer to the number of parties in the conference
	MS_CDT *cdt	pointer to conference descriptor table
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h msilib.h
Category:	Attribute
Mode:	synchronous
Platform:	DI, Springware

Description

The ms_getcnflist( ) function retrieves a conference list. The function returns the total number of parties within a conference, and information specific to each party in that conference. The party-specific information retrieved includes a party's channel, TDM bus time slot number, selector, and attribute description.

Note: The list is not returned in any specified order.

Parameter	Description
devh	the MSI board device handle
confID	the conference identifier
numpty	pointer to the party count
cdt	pointer to conference descriptor table, see MS_CDT for details. Note: The application is responsible for allocating an MS_CDT table with sufficient elements.

If the conference is being monitored, one member of the conference list will be the monitor. chan_num will equal 0x7FFF and chan_sel will be MSPN_TS.

Cautions

This function fails when an invalid conference ID is specified.

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"  
int  dev1;               /* Board dev descriptor variables */
int  partycnt;           /* Number of parties*/
MS_CDT  cdtp[8];         /* Conf. desc. table */
int  confID;             /* Conf. ID */
int  i;  
/* Open board 1 device */
if ((dev1 = ms_open("msiB1",0)) == -1) {
    printf( "Cannot open MSIB1: errno=%d", errno);
    exit(1);
}  
/* Get conference list */
if (ms_getcnflist(dev1, confID, &partycnt, &cdtp[0]) == -1) {
    printf("Error Message = %s",ATDV_ERRMSGP(dev1));
    exit(1);
}  
printf("Number of parties = %d\n", partycnt);  
for (i=0; i<partycnt; i++){
    printf("Chan_num = %x", cdtp[i].chan_num);
    printf("Chan_sel = %x", cdtp[i].chan_sel);
    printf("Chan_att = %x', cdtp[i].chan_attr);
    }
if (ms_close(dev1)== -1){
    printf( "Cannot Close MSIB1: errno=%d", errno);
    exit(1);
}  

See Also

• ms_estconf( )

Click here to contact Telecom Support Resources