Filter
Top Products
52 Voice API for Windows Operating Systems Library Reference — November 2003
ATDX_ANSRSIZ( ) — return the duration of the answer
ATDX_ANSRSIZ( )
return the duration of the answer
!
!!
! Description
The ATDX_ANSRSIZ( ) function returns the duration of the answer that occurs when dx_dial( )
with Basic call progress analysis enabled is called on a channel. An answer is considered the period
of non-silence that begins after cadence is broken and a connection is made. This measurement is
taken before a connect event is returned. The duration of the answer can be used to determine if the
call was answered by a person or an answering machine. This feature is based on the assumption
that an answering machine typically answers a call with a longer greeting than a live person does.
See the Voice API Programming Guide for information about call progress analysis. Also see this
guide for information about how cadence detection parameters affect a connect and are used to
distinguish between a live voice and a voice recorded on an answering machine.
!
!!
! Cautions
None.
!
!!
! Errors
This function will fail and return AT_FAILURE if an invalid channel device handle is specified in
chdev.
!
!!
! Example
/* Call Progress Analysis with user-specified parameters */
#include <stdio.h>
#include <srllib.h>
#include <dxxxlib.h>
Name: long ATDX_ANSRSIZ(chdev)
Inputs: int chdev
• valid channel device handle
Returns: answer duration in 10 msec units if successful
AT_FAILURE if error
Includes: srllib.h
dxxxlib.h
Category: Extended Attribute
Mode: synchronous
Platform: Springware
Parameter Description
chdev specifies the valid channel device handle obtained when the channel was opened
using dx_open( )