Filter
Top Products
Voice API for Windows Operating Systems Library Reference — November 2003 497
call progress analysis parameters — DX_CAP
!
!!
! Description
The DX_CAP data structure contains call progress analysis parameters.
The DX_CAP structure modifies parameters that control frequency detection, cadence detection,
loop current, positive voice detection (PVD), and positive answering machine detection (PAMD).
The DX_CAP structure is used to modify call progress analysis channel parameters when using
dx_dial( ).
For more information about call progress analysis as well as how and when to use the DX_CAP
structure, see the Voice API Programming Guide.
Notes: 1. Use the dx_clrcap( ) function to clear the field values of the DX_CAP structure before using this
structure in a function call. This action prevents possible corruption of data in the allocated
memory space.
2. If you set any DX_CAP field to 0, the field will be reset to the default value for the field. The
setting used by a previous call to dx_dial( ) is ignored.
!
!!
! Field Descriptions
DM3 Boards
On DM3 boards, the following fields of the DX_CAP data structure are supported (DM3 boards
use PerfectCall call progress analysis):
ca_cnosig
Continuous No Signal. The maximum time of silence (no signal) allowed immediately after
cadence detection begins. If exceeded, a “no ringback” is returned.
Length: 2 Default: 4000 Units: 10 msec
ca_intflg
Intercept Mode Flag. Enables or disables SIT frequency detection, positive voice detection
(PVD), and/or positive answering machine detection (PAMD), and selects the mode of
operation for SIT frequency detection.
• DX_OPTDIS – Disable SIT frequency detection, PAMD, and PVD.
This setting provides call progress without SIT frequency detection.
• DX_OPTNOCON – Enable SIT frequency detection and return an “intercept”
immediately after detecting a valid frequency.
This setting provides call progress with SIT frequency detection.
• DX_PVDENABLE – Enable PVD.
This setting provides PVD call analysis only (no call progress).
• DX_PVDOPTNOCON – Enable PVD and DX_OPTNOCON.
This setting provides call progress with SIT frequency detection and PVD call analysis.
• DX_PAMDENABLE – Enable PAMD and PVD.
This setting provides PAMD and PVD call analysis only (no call progress).
• DX_PAMDOPTEN – Enable PAMD, PVD, and DX_OPTNOCON.
This setting provides full call progress and call analysis.
Length: 1 Default: DX_OPTNOCON