<div class="content" name="LINEMEDIACONTROLTONE" uuid="3bf6a9c0-885f-41db-81c8-02cf14066ddd"><p>The LINEMEDIACONTROLTONE packet describes a media action to
be executed when a tone has been detected. It is used as an entry in an array.
The <a href="b3f7fcb1-4451-4179-ab85-a10ea0f7fa06" data-linktype="relative-path">SetMediaControl</a>
packet uses this packet. </p><table>
 <tbody><tr>
  <th><p><br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>1<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>2<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>3<br/>0</p></th>
  <th><p><br/>1</p></th>
 </tr>
 <tr>
  <td colspan="32">dwAppSpecific</td>
 </tr>
 <tr>
  <td colspan="32">dwDuration</td>
 </tr>
 <tr>
  <td colspan="32">dwFrequency1</td>
 </tr>
 <tr>
  <td colspan="32">dwFrequency2</td>
 </tr>
 <tr>
  <td colspan="32">dwFrequency3</td>
 </tr>
 <tr>
  <td colspan="32">dwMediaControl</td>
 </tr>
</tbody></table><p><b>dwAppSpecific (4 bytes): </b>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 <b>dwAppSpecific</b> member MUST be passed
back to the application. </p><p><b>dwDuration (4 bytes): </b>An unsigned 32-bit
integer. The duration of time, in milliseconds, during which the tone SHOULD be
present before detection is made. </p><p><b>dwFrequency1 (4 bytes): </b>An unsigned 32-bit
integer. The first frequency, in hertz, of the tone. </p><p><b>dwFrequency2 (4 bytes): </b>An unsigned 32-bit
integer. The second frequency, in hertz, of the tone. </p><p><b>dwFrequency3 (4 bytes): </b>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 zero is interpreted as
silence and can be use for silence detection. </p><p><b>dwMediaControl (4 bytes): </b>An unsigned 32-bit
integer. The media control action. This member MUST use one of the <a href="3e050929-c418-49ee-b0d9-45e33e6c6f0f" data-linktype="relative-path">LINEMEDIACONTROL_Constants</a>.
</p><p>This packet cannot be extended.</p><p>The LINEMEDIACONTROLTONE packet defines a tuple &lt;tone,
media-control action&gt;. An array of these tuples is passed to the
SetMediaControl packet to set media control actions triggered by media type
changes for a given call. When a change to a listed media type is detected, the
corresponding action on the media stream is invoked.</p><p>A tone with all frequencies set to 0 corresponds to silence.
An application can thus monitor the call&#39;s information stream for silence.</p></div>