ATDV_NAMEP( )

Description | Example | Errors | See Also

Name:	char * ATDV_NAMEP(dev)
Inputs:	int dev	valid Dialogic device handle
Returns:	pointer to string
Includes:	srllib.h
Category:	standard attribute

Description

The ATDV_NAMEP( ) function returns a pointer to an ASCIIZ string that specifies a device name, used to open the device.

An example of a device name is:

• dxxxBbCc

where:

• b is the number of the board in the system
• c is the number of the channel on the D/4x board

The pointer to this string remains valid only while the device is open.

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( "dxxxB1C1", 0 )) == -1 ){  
      printf( "Error: cannot open device\n" );  
      exit( 1 );  
   }
  
   printf( "Device name is %s\n", ATDV_NAMEP( dxxxdev ));  
}

Errors

This function returns a pointer to the string "Unknown device" 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