Voice API for HMP Library Reference - Dialogic

ATDX_TONEID( ) — return user-defined tone ID that terminated I/O function
ATDX_TONEID( )
return user-defined tone ID that terminated I/O function
Name: long ATDX_TONEID(chdev)
Inputs: int chdev valid channel device handle
Returns: user-defined tone ID if successful
AT_FAILURE if error
Includes: srllib.h
dxxxlib.h
Category: Extended Attribute
Mode: synchronous
� Description
The ATDX_TONEID( ) function returns the user-defined tone ID that terminated an I/O function.
This termination is indicated by ATDX_TERMMSK( ) returning TM_TONE.
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was opened
using dx_open( )
� Cautions
None.
� Errors
This function will fail and return AT_FAILURE if an invalid channel device handle is specified in
chdev.
� Example
#include
#include
#include
#define TID_1 101
main()
{
TN_GEN tngen;
DV_TPT tpt[ 5 ];
int chdev;
48 Voice API for HMP Library Reference — September 2004