Intel 05-1832-002 IP Phone User Manual


 
54 Voice API for Windows Operating Systems Library Reference — November 2003
ATDX_BDNAMEP( ) — return a pointer to the board device name
ATDX_BDNAMEP( )
return a pointer to the board device name
!
!!
! Description
The ATDX_BDNAMEP( ) function returns a pointer to the board device name on which the
channel accessed by chdev resides.
As illustrated in the example, this may be used to open the board device that corresponds to a
particular channel device prior to setting board parameters.
!
!!
! Cautions
None.
!
!!
! Errors
This function will fail and return a pointer to “Unknown device” if an invalid channel device handle
is specified in chdev.
!
!!
! Example
#include <stdio.h>
#include <srllib.h>
#include <dxxxlib.h>
main()
{
int chdev, bddev;
char *bdnamep;
.
Name: char * ATDX_BDNAMEP(chdev)
Inputs: int chdev
valid channel device handle
Returns: pointer to board device name string if successful
pointer to ASCIIZ string “Unknown device” if error
Includes: srllib.h
dxxxlib.h
Category: Extended Attribute
Mode: synchronous
Platform: DM3, Springware
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was opened
using dx_open( )