Voice API for HMP Library Reference - Dialogic

ATDX_CHNUM( ) — return the channel number
ATDX_CHNUM( )
return the channel number
Name: long ATDX_CHNUM(chdev)
Inputs: int chdev valid channel device handle
Returns: channel number if successful
AT_FAILURE if error
Includes: srllib.h
dxxxlib.h
Category: Extended Attribute
Mode: synchronous
� Description
The ATDX_CHNUM( ) function returns the channel number associated with the channel device
chdev. Channel numbering starts at 1.
For example, use the channel as an index into an array of channel-specific information.
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was opened
using dx_open( )
� Cautions
None.
� Errors
This function will fail and return AT_FAILURE if an invalid channel device handle is specified in
chdev.
� Example
#include
#include
main()
{
int chdev;
long chno;
.
.
/* Open the channel device */
if ((chdev = dx_open("dxxxB1C1", NULL)) == -1) {
/* Process error */
}
/* Get Channel number */
if((chno = ATDX_CHNUM(chdev)) == AT_FAILURE) {
/* Process error */
30 Voice API for HMP Library Reference — September 2004