Filter
Top Products
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.
A possible use for this attribute is to display the names of the channel devices associated with a
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.
!
!!
! 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
Includes: srllib.h
dxxxlib.h
Category: Extended Attribute
Mode: synchronous
Platform: DM3, Springware
Parameter Description
bddev specifies the valid board device handle obtained when the board was opened
using dx_open( )