92 Global Call API for HMP on Windows Programming Guide — August 2006
Call Control
GCPR_CALLPROGRESS and GCPR_MEDIADETECT parameters. See the Global Call E1/T1
CAS/R2 Technology User’s Guide for more information.
Table12 shows how the CCPARM_CA_MODE values correspond to the
GCPR_CALLPROGRESS and GCPR_MEDIADETECT parameters. This table is provided as a
convenience for users that have previously used the gc_SetParm() method and now wish to use
the greater flexibility provided by gc_MakeCall( ) with the CCPARM_CA_MODE parameter.
Note: The gc_SetConfigData( ) method of setting call progress analysis on a per channel basis is an
enhancement over using the gc_SetParm() with the GCPR_MEDIADETECT and/or
GCPR_CALLPROGRESS parameters. Applications should not use both the gc_SetConfigData( )
method and the gc_SetParm( ) method on the same line device. If both methods are used, the
gc_SetConfigData( ) method takes precedence.
7.2.6 Setting Call Analysis Attributes on a Per Channel Basis
In addition to enabling and disabling call progress analysis on a per channel basis, certain call
analysis attributes can be configured on a per channel basis using the gc_SetConfigData()
function. The relevant function parameter values in this context are:
target_type
GCTGT_CCLIB_CHAN
target_id
the line device
target_datap
a pointer to a GC_PARM_BLK structure that contains the following parameter set ID and
parameter IDs:
•SetId – CCSET_CALLANALYSIS
•ParmId – Any of the values described in Section 7.2.4, “Setting Call Analysis Attributes
on a Per Call Basis”, on page 90.
7.2.7 Customizing Call Progress Tones on a Per Board Basis
When using Digital Network Interfaceboards, an application can create, delete and query call
progress tones on a per board device basis using the dx_createtone(), dx_deletetone( ), and
dx_querytone() functions and the associated TONE_DATA structure in the Voice API. See the
Voice API Programming Guide for more information.
Table12. Comparison with Call Progress Analysis Using gc_SetParm()
GCPR_CALLPROGRESS GCPR_MEDIADETECT Equivalent CCPARM_CA_MODE Value
GCPV_DISABLE GCPV_DISABLE GC_CA_DISABLE
GCPV_DISABLE GCPV_ENABLE GC_CA_POSTONLY_PVD_PAMD
GCPV_ENABLE GCPV_DISABLE GC_CA_PREONLY_SIT
GCPV_ENABLE GCPV_ENABLE GC_CA_ENABLE_ALL