ATDX_CHNUM( )

Description | Cautions | Example | Errors

Name:	long ATDX_CHNUM(chdev)
Inputs:	int chdev	valid Dialogic channel device handle
Returns:	channel number if successful AT_FAILURE if error
Includes:	srllib.h dxxxlib.h
Category:	Extended Attribute

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.

Cautions

None.

Example

#include <srllib.h>  
#include <dxxxlib.h>  
#include <windows.h>  
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 */  
   }  
   /* Use chno for application-specific purposes */  
   .  
   .  
}

Errors

This function will fail and return AT_FAILURE if an invalid channel device handle is specified in chdev.

Click here to contact Dialogic Customer Engineering