(Page 38 of 69 in this chapter) Version
adiStartDTMFDetector
Description
- Enables the detection of DTMFs.
Prototype
- DWORD adiStartDTMFDetector ( CTAHD ctahd,
ADI_DTMFDETECT_PARMS *parms)
- ctahd CTA context handle returned by ctaCreateContext.
- 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
- For most AG hardware, this function requires that dtmf.dsp or dtmfe.dsp has been loaded. On AG 2000 boards and AG 4000/C boards, dtmf.m54 or dtmfe.m54 must be loaded to the board before adiStartDTMFDetector will work.
- On CG 6000C boards, dtmf.f54 or dtmfe.f54 must be loaded to the board before adiStartDTMFDetector will work.
- For QX hardware, this function is supported in the standard DSP file.
Details
- This function enables detection of DTMFs. By default, the DTMF detector is active after the NOCC protocol is started, or when the CTA 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, *, or # in the event value field.
Note: The DTMF detector must be enabled for the digit collection functions (for example, adiCollectDigits, adiGetDigit).
See Also
- adiStopDTMFDetector
(Page 38 of 69 in this chapter) Version
Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights
reserved.