6.14. ToneParm

The ToneParm data structure is used to redefine a firmware-applied tone's attributes using the cc_ToneRedefine( ) or to play a user-defined tone using the cc_PlayTone( ) function.

The data structure is defined as follows:

Struct toneParm  
{  
    uint16    duration;    //1 ~ 65535 (in 10 ms, 0xffff - forever)    
    uint16    freq1;       //200 ~ 3100 Hz  
    int16     amp1;        //-40 ~ +3 dB  
    uint16    freq2;       //200 ~ 3100 Hz  
    int16     amp2;        //-40 ~ +3 dB  
    uint16    toneOn1;     //1 ~ 65535 (in 10 ms)  
    uint16    toneOff1;    //0 ~ 65534 (in 10 ms)  
    uint16    reserv1;     //reserved for future use  
    uint16    reserv2;     //reserved for future use  
}

Table 44. ToneParm Field Descriptions

Field	Description
duration	specifies the duration of the tone in 10 ms units. The range is 1 - 65535. Set to -1 to play forever.
freq1	specifies the frequency of the tone. The range is 200 - 3100 Hz.
amp1	specifies the amplitude of the tone. The range is -40 - +3 dB.
freq2	specifies the frequency of the tone. The range is 200-3100 Hz.
amp2	specifies the amplitude of the tone. The range is -40 - +3 dB.
toneOn1	specifies the tone interval, in 10 ms units. The range is 1 - 65535 ms. Set to 1 or greater for continuous tone.
toneOff1	specifies the tone interval, in 10 ms units. The range is 0 - 65534 ms. Set to 0 to play a continuous tone.
reserv1	Reserved for future use
reserv2	Reserved for future use

Click here to contact Dialogic Customer Engineering