Intel 05-1832-002 User Manual

Page of 564
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 
 
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( )