CDI_TONE_PARMS

CDI_TONE_PARMS controls the operation of the tones.

Dependent function

cdiStartTones

Field name

Type

Units

Default

Description

freq1

DWORD

Hz

0

Frequency component.

Valid values: 0 - 4000

freq2

DWORD

Hz

0

Second frequency component if the tone consists of two frequency components. Set to 0 if the tone consists of only one frequency.

Valid values: 0 - 4000

ampl1

INT32

dB

0

Amplitude of freq1.

Valid values: 0 to -100

ampl2

INT32

dB

0

Amplitude of freq2. Set to -100 if freq2 is 0.

Valid values: 0 to -100

ontime

DWORD

ms

0

Duration of the tone.

Valid values: 0 - 8000

offtime

DWORD

ms

0

Duration of the silence after the tone, before the tone is repeated (because iterations, ontime2, or both are greater than 0).

Valid values: 0 - 8000

ontime2

DWORD

ms

0

Duration of the second iteration of the tone if the cadence consists of two iterations. Set to 0 if the cadence consists of only one iteration.

Valid values: 0 - 8000

offtime2

DWORD

ms

0

Duration of the silence after the second iteration of the tone, before the cadence begins again. Set to 0 if the cadence consists of only one iteration.

Valid values: 0 - 8000

iterations

INT32

N/A

-1

Number of times to repeat the cadence.

Valid values: 1 - 65535, or -1 for infinite repeats