6.7.  TN_INFO: Tone Information

The TN_INFO structure is declared as follows:

typedef struct {

   unsigned short int  tn_freq1;     /* 1st tone frequency in Hz */

   unsigned short int  tn_freq2;     /* 2nd tone frequency in Hz */

   unsigned short int  tn_on;        /* cadence on-time (10 ms units) */

   unsigned short int  tn_off;       /* cadence off-time (10 ms units) */

   unsigned short int  tn_rep_cnt;   /* actual rep count */

} TN_INFO;

The TN_INFO structure description is provided here for reference purposes. This structure is included in the TN_INFOLIST structure.

The tone information structure (TN_INFO) reports the data on which learn mode bases the final tone description. It provides the actual frequency and actual on/off times for each frame (sample) of a detected tone. This information is used primarily for debugging. If the final tone description does not detect a tone as desired, you can analyze this data to obtain an accurate picture of the tone.

Table 6.  TN_INFO Structure

Parameter	Description
tn_freq1	Length: 2 (unsigned short int) Units: Hz Frequency 1: Returns the frequency in Hz of the first tone in the tone sample.
tn_freq2	Length: 2 (unsigned short int) Units: Hz Frequency 2: Returns the frequency in Hz of the second tone in the tone sample.
tn_on	Length: 2 (unsigned short int) Units: 10 ms On-Time: Returns the tone-on time in 10 ms units for the tone sample.
tn_off	Length: 2 (unsigned short int) Units: 10 ms Off-Time: Returns the tone-off time in 10 ms units for the tone sample.
tn_rep_cnt	Length: 2 (unsigned short int) Default: 0 Tone-On/Off Repetition Count: Not Used for learn mode tone information (always 0).

Click here to contact Telecom Support Resources