ATDV_SUBDEVS( )

Description | Example | Errors | See Also

Name:	long ATDV_SUBDEVS(dev)
Inputs:	int dev	valid Dialogic device handle
Returns:	AT_FAILURE if failure, otherwise
	number of subdevices
Includes:	srllib.h
Category:	standard attribute

Description

The ATDV_SUBDEVS( ) function returns the number of subdevices for the device. This number is returned as an integer.

Examples of subdevices are time slots on a DTI/xxx board and channels on a D/xxx board.

Parameter	Description
dev	Device handle, the handle returned by the technology-specific xx_open( ).

Example

#include <windows.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
main()  
{  
   int dxxxdev;
  
   /* Open a dxxx channel device */  
   if(( dxxxdev = dx_open( "dxxxB1", 0 )) == -1 ){  
      printf( "Error: cannot open device\n" );  
      exit( 1 );  
   }
  
   printf( "Device has %d subdevices\n", ATDV_SUBDEVS( dxxxdev ));  
}

Errors

This function fails and returns the value defined by AT_FAILURE if an invalid device handle is specified in dev.

See Also

• The appropriate technology-specific Programmer's Guide

Click here to contact Dialogic Customer Engineering