Voice API for HMP Library Reference - Dialogic

ATDX_TERMMSK( ) — return the reason for the last I/O function termination
TM_USRSTOP
Function stopped by user
� Cautions
� Errors
If several termination conditions are met at the same time, several bits will be set in the
termination bitmap.
When both DX_MAXDTMF and DX_DIGMASK termination conditions are specified in the
DV_TPT structure, and both conditions are satisfied, the ATDX_TERMMSK( ) function will
return the TM_MAXDTMF termination event only.
For example, with a DX_MAXDTMF condition of 2 digits maximum and a DX_DIGMASK
condition of digit “1”, if the digit string “21” is received, both conditions are satisfied but only
TM_MAXDTMF will be reported by ATDX_TERMMSK( ).
This behavior differs from Springware products, where both TM_MAXDTMF and
TM_DIGIT will be returned when both DX_MAXDTMF and DX_DIGMASK termination
conditions are specified in the DV_TPT structure and both are satisfied by the user input.
This function will fail and return AT_FAILURE if an invalid channel device handle is specified in
chdev.
� Example
#include
#include
#include
#include
main()
{
int chdev;
long term;
DX_IOTT iott;
DV_TPT tpt[4];
/* Open the channel device */
if ((chdev = dx_open("dxxxB1C1",NULL)) == -1) {
/* Process error */
}
/* Record a voice file. Terminate on receiving a digit, silence, loop
* current drop, max time, or reaching a byte count of 50000 bytes.
*/
/* set up DX_IOTT */
iott.io_type = IO_DEV|IO_EOT;
iott.io_bufp = 0;
iott.io_offset = 0;
iott.io_length = 50000;
if((iott.io_fhandle = dx_fileopen("file.vox", O_RDWR)) == -1) {
/* process error */
}
46 Voice API for HMP Library Reference — September 2004