Intel 05-1832-002 User Manual
60
Voice API for Windows Operating Systems Library Reference — November 2003
ATDX_CHNAMES( ) — retrieve all channel names for a board
ATDX_CHNAMES( )
retrieve all channel names for a board
!
!
!
! Description
The ATDX_CHNAMES( ) function returns a pointer to an array of channel names associated with
the specified board device handle, bddev.
the specified board device handle, bddev.
A possible use for this attribute is to display the names of the channel devices associated with a
particular board device.
particular board device.
!
!
!
! Cautions
None.
!
!
!
! Errors
This function will fail and return the address of a pointer to “Unknown device” if an invalid board
device handle is specified in bddev.
device handle is specified in bddev.
!
!
!
! Example
#include <stdio.h>
#include <srllib.h>
#include <dxxxlib.h>
main()
{
int bddev, cnt;
char **chnames;
long subdevs;
.
.
/* Open the board device */
if ((bddev = dx_open("dxxxB1",NULL)) == -1) {
Name:
char ** ATDX_CHNAMES(bddev)
Inputs:
int bddev
•
valid board device handle
Returns:
pointer to array of channel names if successful
pointer to array of pointers that point to “Unknown device” if error
pointer to array of pointers that point to “Unknown device” if error
Includes:
srllib.h
dxxxlib.h
dxxxlib.h
Category:
Extended Attribute
Mode:
synchronous
Platform:
DM3, Springware
Parameter
Description
bddev