(Page 48 of 80 in this chapter)

adiStartDTMF

Description

Starts the generation of a string of DTMFs or MFs.

Prototype

DWORD adiStartDTMF( CTAHD ctahd,
char *digits,
ADI_DTMF_PARMS *parms )
ctahd Context handle returned by adiOpenPort.
digits Pointer to a string of DTMF digits including 0...9, A...F, *, # and `,' (comma) or `.' (period) for pauses (all other characters are ignored).
parms Pointer to DTMF parameters according to the following structure (NULL value uses the default values): typedef struct { DWORD size; /* size of this structure */ INT32 ampl1; /* level of first tone (dBm) */ INT32 ampl2; /* level of second tone (dBm) */ DWORD ontime; /* on duration of DTMF tone (ms) */ DWORD offtime; /* off duration of DTMF tone (ms) */ DWORD shortpause; /* duration of ',' (ms) */ DWORD longpause; /* duration of '.' (ms) */ } ADI_DTMF_PARMS;

Return Values

SUCCESS
CTAERR_INVALID_CTAHD
CTAERR_OUTPUT_ACTIVE.
CTAERR_TONES_ACTIVE

Events

ADIEVN_TONES_DONE
The value (reason) field can contain CTA_REASON_FINISHED or CTA_REASON_STOPPED.
ADIEVN_DTMF_DETECT_DONE

DSP File Requirement

This function requires that tones.dsp has been loaded by agmon.

Details

Starts generation of a sequence of DTMF tones or MF tones. Generation can be terminated using the adiStopTones command.
digits may contain the following embedded escape characters which control the dialing sequence, as listed below: Character Description . (period) Insert long pause in dialing. , (comma) Insert short pause in dialing. T Switch to DTMF dialing (default). M Switch to MF dialing.
To generate MF tones, precede the string with an "M". See page 151 for a detailed table of MF tones.

See Also

adiStartTones, adiStopTones, adiStartMFDetector (for MF table)

(Page 48 of 80 in this chapter)

Tech_Support@nmss.com

Copyright © 1996, Natural MicroSystems, Inc. All rights reserved.