Voice API for HMP Library Reference - Dialogic

ATDX_CHNAMES( ) — retrieve all channel names for a board
ATDX_CHNAMES( )
retrieve all channel names for a board
Name: char ** ATDX_CHNAMES(bddev)
Inputs: int bddev valid board device handle
Returns: pointer to array of channel names if successful
pointer to array of pointers that point to “Unknown device” if error
Includes: srllib.h
dxxxlib.h
Category: Extended Attribute
Mode: synchronous
� Description
The ATDX_CHNAMES( ) function returns a pointer to an array of channel names associated with
the specified board device handle, bddev.
A possible use for this attribute is to display the names of the channel devices associated with a
particular board device.
Parameter Description
bddev specifies the valid board device handle obtained when the board was opened
using dx_open( )
� Cautions
None.
� Errors
This function will fail and return the address of a pointer to “Unknown device” if an invalid board
device handle is specified in bddev.
� Example
#include
#include
#include
main()
{
int bddev, cnt;
char **chnames;
long subdevs;
.
.
/* Open the board device */
if ((bddev = dx_open("dxxxB1",NULL)) == -1) {
/* Process error */
28 Voice API for HMP Library Reference — September 2004