2.2.6.37 LINEMONITORTONE

The LINEMONITORTONE packet describes a tone to be monitored. This is used as an entry in an array. The MonitorTones packet uses this packet.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

dwAppSpecific

dwDuration

dwFrequency1

dwFrequency2

dwFrequency3

dwAppSpecific (4 bytes): An unsigned 32-bit integer. This field is used by the application for tagging the tone. When this tone is detected, the value of the dwAppSpecific member MUST be passed back to the application.

dwDuration (4 bytes): An unsigned 32-bit integer. The duration of time, in milliseconds, during which the tone SHOULD be present before a detection is made.

dwFrequency1 (4 bytes): An unsigned 32-bit integer. The first frequency, in hertz, of the tone.

dwFrequency2 (4 bytes): An unsigned 32-bit integer. The second frequency, in hertz, of the tone.

dwFrequency3 (4 bytes): An unsigned 32-bit integer. The third frequency, in hertz, of the tone. If fewer than three frequencies are needed in the tone, a value of 0 SHOULD be used for the unused frequencies. A tone with all three frequencies set to 0 is interpreted as silence and can be use for silence detection.

This packet cannot be extended.

The LINEMONITORTONE packet defines a tone for the purpose of detection. An array of tones is passed to the MonitorTones packet, which monitors these tones and sends a LINE_MONITORTONE packet to the application when a detection is made.

A tone with all frequencies set to 0 corresponds to silence. An application can thus monitor the call's information stream for silence.