(Page 49 of 80 in this chapter)


adiStartDTMFDetector

Description

Enables the detection of DTMFs.

Prototype

DWORD adiStartDTMFDetector( CTAHD ctahd,
ADI_DTMFDETECT_PARMS *parms)

ctahd Context handle returned by adiOpenPort.

parms Pointer to DTMF detection parameters according to the following structure (NULL value uses the default values):

typedef struct
{
DWORD size; /* size of this structure */
DWORD columnfour; /* 1=detect DTMFs A,B,C,D; 0=don't */
INT32 onqualampl; /* min input lev to qual tone (dBm) */
DWORD onthreshold; /* reserved */
DWORD onqualtime; /* qualify time of DTMF (ms) */
INT32 offqualampl; /* min input lev of valid DTMF (dBm)*/
DWORD offthreshold; /* reserved */
DWORD offqualtime; /* disqualify time for tone (ms) */
} ADI_DTMFDETECT_PARMS;

Return Values

Events

DSP File Requirement

This function requires that dtmf.dsp or dtmfe.dsp has been loaded by agmon.

Details

This function enables detection of DTMFs. By default, the DTMF detector is active after the NOCC protocol is started, or when the context enters the call control connected state. Therefore, this function is only needed to re-start the DTMF detector if it was stopped using adiStopDTMFDetector, or to modify the DTMF detector parameters.

ADIEVN_DIGIT_BEGIN and ADIEVN_DIGIT_END events are generated for every digit detected. Each event contains the ASCII representation (character) of the digit: `0'-'9', 'A'-'D', '*', and `#' in the event value field.

Note: The DTMF detector must be enabled for the digit collection functions (e.g., adiCollectDigits, adiGetDigit).

See Also

adiStopDTMFDetector, ADI_CALLCTL_PARMS mediamask



(Page 49 of 80 in this chapter)


Tech_Support@nmss.com
Copyright © 1996, Natural MicroSystems, Inc. All rights reserved.