← Back to branch summary

~ubuntu-branches/ubuntu/maverick/telepathy-glib/maverick

« back to all changes in this revision

Viewing changes to docs/reference/html/telepathy-glib-channel-media.html

  • Committer: Bazaar Package Importer
  • Author(s): Simon McVittie
  • Date: 2010-05-25 16:57:39 UTC
  • mfrom: (1.6.2 upstream) (30.1.1 experimental)
  • Revision ID: james.westby@ubuntu.com-20100525165739-kted5mhm904f8lwj
Tags: 0.11.6-1
* New upstream version
  - requires gtk-doc 1.15
  - requires gobject-introspection 0.6.11
  - new ABI, API
* Merge from experimental
  - add gir1.0-telepathyglib-0.12 binary package

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/telepathy-glib-channel-media.html
8
8
<link rel="up" href="ch-client.html" title="Client-side proxies">
9
9
<link rel="prev" href="telepathy-glib-channel-text.html" title="Text channels">
10
10
<link rel="next" href="telepathy-glib-channel-file-transfer.html" title="File transfer">
11
 
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
264
264
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
265
265
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
266
266
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
267
<a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * <a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-call-multiple-tones" title="tp_cli_channel_interface_dtmf_call_multiple_tones ()">tp_cli_channel_interface_dtmf_call_multiple_tones</a>
 
268
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
269
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
270
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Tones</code></em>,
 
271
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-callback-for-multiple-tones" title="tp_cli_channel_interface_dtmf_callback_for_multiple_tones ()"><span class="type">tp_cli_channel_interface_dtmf_callback_for_multiple_tones</span></a> callback</code></em>,
 
272
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
273
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
274
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
275
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-callback-for-multiple-tones" title="tp_cli_channel_interface_dtmf_callback_for_multiple_tones ()">*tp_cli_channel_interface_dtmf_callback_for_multiple_tones</a>)
 
276
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
277
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
278
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
279
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
280
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-connect-to-sending-tones" title="tp_cli_channel_interface_dtmf_connect_to_sending_tones ()">tp_cli_channel_interface_dtmf_connect_to_sending_tones</a>
 
281
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
282
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-signal-callback-sending-tones" title="tp_cli_channel_interface_dtmf_signal_callback_sending_tones ()"><span class="type">tp_cli_channel_interface_dtmf_signal_callback_sending_tones</span></a> callback</code></em>,
 
283
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
284
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
285
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
286
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
287
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-signal-callback-sending-tones" title="tp_cli_channel_interface_dtmf_signal_callback_sending_tones ()">*tp_cli_channel_interface_dtmf_signal_callback_sending_tones</a>)
 
288
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
289
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Tones</code></em>,
 
290
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
291
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
 
292
<a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * <a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-connect-to-stopped-tones" title="tp_cli_channel_interface_dtmf_connect_to_stopped_tones ()">tp_cli_channel_interface_dtmf_connect_to_stopped_tones</a>
 
293
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
294
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-signal-callback-stopped-tones" title="tp_cli_channel_interface_dtmf_signal_callback_stopped_tones ()"><span class="type">tp_cli_channel_interface_dtmf_signal_callback_stopped_tones</span></a> callback</code></em>,
 
295
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
296
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
297
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
298
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
299
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-signal-callback-stopped-tones" title="tp_cli_channel_interface_dtmf_signal_callback_stopped_tones ()">*tp_cli_channel_interface_dtmf_signal_callback_stopped_tones</a>)
 
300
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
301
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_Cancelled</code></em>,
 
302
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
303
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);
267
304
 
268
305
<span class="returnvalue">void</span>                (<a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-hold-callback-for-get-hold-state" title="tp_cli_channel_interface_hold_callback_for_get_hold_state ()">*tp_cli_channel_interface_hold_callback_for_get_hold_state</a>)
269
306
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
2007
2044
state.
2008
2045
</p>
2009
2046
<p>
2010
 
Start sending a DTMF tone on this stream. Where possible, the tone         will continue until &lt;tp:member-ref&gt;StopTone&lt;/tp:member-ref&gt; is called.         On certain protocols, it may         only be possible to send events with a predetermined length. In this         case, the implementation may emit a fixed-length tone, and the StopTone         method call should return NotAvailable.
 
2047
&lt;p&gt;Start sending a DTMF tone to all eligible streams in the channel.           Where possible, the tone will continue until           &lt;tp:member-ref&gt;StopTone&lt;/tp:member-ref&gt; is called. On certain protocols,           it may only be possible to send events with a predetermined length. In           this case, the implementation MAY emit a fixed-length tone, and the           StopTone method call SHOULD return NotAvailable.&lt;/p&gt;           &lt;tp:rationale&gt;             The client may wish to control the exact duration and timing of the             tones sent as a result of user's interaction with the dialpad, thus             starting and stopping the tone sending explicitly.           &lt;/tp:rationale&gt;          &lt;p&gt;Tone overlaping or queueing is not supported, so this method can only           be called if no DTMF tones are already being played.&lt;/p&gt;
2011
2048
</p>
2012
2049
<div class="variablelist"><table border="0">
2013
2050
<col align="left" valign="top">
2024
2061
</tr>
2025
2062
<tr>
2026
2063
<td><p><span class="term"><em class="parameter"><code>in_Stream_ID</code></em> :</span></p></td>
2027
 
<td>Used to pass an 'in' argument: A stream ID as defined in the StreamedMedia channel type.
 
2064
<td>Used to pass an 'in' argument: A stream ID as defined in the StreamedMedia channel         type. This argument is included for backwards compatibility and MUST         be ignored by the implementations - the tone SHOULD be sent to all         eligible streams in the channel.
2028
2065
</td>
2029
2066
</tr>
2030
2067
<tr>
2076
2113
state.
2077
2114
</p>
2078
2115
<p>
2079
 
Stop sending any DTMF tone which has been started using the         &lt;tp:member-ref&gt;StartTone&lt;/tp:member-ref&gt;         method. If there is no current tone, this method will do nothing.
 
2116
Stop sending any DTMF tones which have been started using the         &lt;tp:member-ref&gt;StartTone&lt;/tp:member-ref&gt; or         &lt;tp:member-ref&gt;MultipleTones&lt;/tp:member-ref&gt; methods.         If there is no current tone, this method will do nothing.         If MultipleTones was used, the client should not assume the         sending has stopped immediately; instead, the client should wait         for the StoppedTones signal.         &lt;tp:rationale&gt;           On some protocols it might be impossible to cancel queued tones           immediately.         &lt;/tp:rationale&gt;
2080
2117
</p>
2081
2118
<div class="variablelist"><table border="0">
2082
2119
<col align="left" valign="top">
2093
2130
</tr>
2094
2131
<tr>
2095
2132
<td><p><span class="term"><em class="parameter"><code>in_Stream_ID</code></em> :</span></p></td>
2096
 
<td>Used to pass an 'in' argument: A stream ID as defined in the StreamedMedia channel type.
 
2133
<td>Used to pass an 'in' argument: A stream ID as defined in the StreamedMedia channel         type. This argument is included for backwards compatibility and MUST         be ignored by the implementations - the sending SHOULD be stoped in         all eligible streams in the channel.
2097
2134
</td>
2098
2135
</tr>
2099
2136
<tr>
2135
2172
Start a StartTone method call.
2136
2173
</p>
2137
2174
<p>
2138
 
Start sending a DTMF tone on this stream. Where possible, the tone         will continue until &lt;tp:member-ref&gt;StopTone&lt;/tp:member-ref&gt; is called.         On certain protocols, it may         only be possible to send events with a predetermined length. In this         case, the implementation may emit a fixed-length tone, and the StopTone         method call should return NotAvailable.
 
2175
&lt;p&gt;Start sending a DTMF tone to all eligible streams in the channel.           Where possible, the tone will continue until           &lt;tp:member-ref&gt;StopTone&lt;/tp:member-ref&gt; is called. On certain protocols,           it may only be possible to send events with a predetermined length. In           this case, the implementation MAY emit a fixed-length tone, and the           StopTone method call SHOULD return NotAvailable.&lt;/p&gt;           &lt;tp:rationale&gt;             The client may wish to control the exact duration and timing of the             tones sent as a result of user's interaction with the dialpad, thus             starting and stopping the tone sending explicitly.           &lt;/tp:rationale&gt;          &lt;p&gt;Tone overlaping or queueing is not supported, so this method can only           be called if no DTMF tones are already being played.&lt;/p&gt;
2139
2176
</p>
2140
2177
<div class="variablelist"><table border="0">
2141
2178
<col align="left" valign="top">
2153
2190
</tr>
2154
2191
<tr>
2155
2192
<td><p><span class="term"><em class="parameter"><code>in_Stream_ID</code></em> :</span></p></td>
2156
 
<td>Used to pass an 'in' argument: A stream ID as defined in the StreamedMedia channel type.
 
2193
<td>Used to pass an 'in' argument: A stream ID as defined in the StreamedMedia channel         type. This argument is included for backwards compatibility and MUST         be ignored by the implementations - the tone SHOULD be sent to all         eligible streams in the channel.
2157
2194
</td>
2158
2195
</tr>
2159
2196
<tr>
2215
2252
Start a StopTone method call.
2216
2253
</p>
2217
2254
<p>
2218
 
Stop sending any DTMF tone which has been started using the         &lt;tp:member-ref&gt;StartTone&lt;/tp:member-ref&gt;         method. If there is no current tone, this method will do nothing.
 
2255
Stop sending any DTMF tones which have been started using the         &lt;tp:member-ref&gt;StartTone&lt;/tp:member-ref&gt; or         &lt;tp:member-ref&gt;MultipleTones&lt;/tp:member-ref&gt; methods.         If there is no current tone, this method will do nothing.         If MultipleTones was used, the client should not assume the         sending has stopped immediately; instead, the client should wait         for the StoppedTones signal.         &lt;tp:rationale&gt;           On some protocols it might be impossible to cancel queued tones           immediately.         &lt;/tp:rationale&gt;
2219
2256
</p>
2220
2257
<div class="variablelist"><table border="0">
2221
2258
<col align="left" valign="top">
2233
2270
</tr>
2234
2271
<tr>
2235
2272
<td><p><span class="term"><em class="parameter"><code>in_Stream_ID</code></em> :</span></p></td>
2236
 
<td>Used to pass an 'in' argument: A stream ID as defined in the StreamedMedia channel type.
 
2273
<td>Used to pass an 'in' argument: A stream ID as defined in the StreamedMedia channel         type. This argument is included for backwards compatibility and MUST         be ignored by the implementations - the sending SHOULD be stoped in         all eligible streams in the channel.
2237
2274
</td>
2238
2275
</tr>
2239
2276
<tr>
2354
2391
</table></div>
2355
2392
</div>
2356
2393
<hr>
 
2394
<div class="refsect2" title="tp_cli_channel_interface_dtmf_call_multiple_tones ()">
 
2395
<a name="tp-cli-channel-interface-dtmf-call-multiple-tones"></a><h3>tp_cli_channel_interface_dtmf_call_multiple_tones ()</h3>
 
2396
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="returnvalue">TpProxyPendingCall</span></a> * tp_cli_channel_interface_dtmf_call_multiple_tones
 
2397
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
2398
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> timeout_ms</code></em>,
 
2399
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *in_Tones</code></em>,
 
2400
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-callback-for-multiple-tones" title="tp_cli_channel_interface_dtmf_callback_for_multiple_tones ()"><span class="type">tp_cli_channel_interface_dtmf_callback_for_multiple_tones</span></a> callback</code></em>,
 
2401
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2402
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
2403
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
 
2404
<p>
 
2405
Start a MultipleTones method call.
 
2406
</p>
 
2407
<p>
 
2408
&lt;p&gt;Send multiple DTMF events to all eligible streams in the channel.         Each character in the Tones string must be a valid DTMF event         (as defined by         &lt;a href="http://www.rfc-editor.org/rfc/rfc4733.txt"&gt;RFC4733&lt;/a&gt;).         Each tone will be played for a pre-defined number of milliseconds,         followed by a pause before the next tone is played.  The         duration/pause is defined by the protocol or connection manager.&lt;/p&gt;         &lt;tp:rationale&gt;           In cases where the client knows in advance the tone sequence it wants           to send, it's easier to use this method than manually start and stop           each tone in the sequence.         &lt;/tp:rationale&gt;          &lt;p&gt;Tone overlaping or queueing is not supported, so this method can only           be called if no DTMF tones are already being played.&lt;/p&gt;
 
2409
</p>
 
2410
<div class="variablelist"><table border="0">
 
2411
<col align="left" valign="top">
 
2412
<tbody>
 
2413
<tr>
 
2414
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
2415
<td>the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a>
 
2416
</td>
 
2417
</tr>
 
2418
<tr>
 
2419
<td><p><span class="term"><em class="parameter"><code>timeout_ms</code></em> :</span></p></td>
 
2420
<td>the timeout in milliseconds, or -1 to use the
 
2421
  default
 
2422
</td>
 
2423
</tr>
 
2424
<tr>
 
2425
<td><p><span class="term"><em class="parameter"><code>in_Tones</code></em> :</span></p></td>
 
2426
<td>Used to pass an 'in' argument: A string representation of one or more DTMF           events.
 
2427
</td>
 
2428
</tr>
 
2429
<tr>
 
2430
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
2431
<td>called when the method call succeeds or fails;
 
2432
  may be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to make a "fire and forget" call with no 
 
2433
  reply tracking
 
2434
</td>
 
2435
</tr>
 
2436
<tr>
 
2437
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
2438
<td>user-supplied data passed to the callback;
 
2439
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
2440
</td>
 
2441
</tr>
 
2442
<tr>
 
2443
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
 
2444
<td>called with the user_data as argument, after the
 
2445
  call has succeeded, failed or been cancelled;
 
2446
  must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
2447
</td>
 
2448
</tr>
 
2449
<tr>
 
2450
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
2451
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be 
 
2452
  weakly referenced; if it is destroyed, this call 
 
2453
  will automatically be cancelled. Must be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if 
 
2454
  <em class="parameter"><code>callback</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
2455
</td>
 
2456
</tr>
 
2457
<tr>
 
2458
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
2459
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxyPendingCall" title="TpProxyPendingCall"><span class="type">TpProxyPendingCall</span></a> representing the call in
 
2460
 progress. It is borrowed from the object, and will become
 
2461
 invalid when the callback is called, the call is
 
2462
 cancelled or the <a class="link" href="telepathy-glib-proxy.html#TpProxy"><span class="type">TpProxy</span></a> becomes invalid.
 
2463
</td>
 
2464
</tr>
 
2465
</tbody>
 
2466
</table></div>
 
2467
</div>
 
2468
<hr>
 
2469
<div class="refsect2" title="tp_cli_channel_interface_dtmf_callback_for_multiple_tones ()">
 
2470
<a name="tp-cli-channel-interface-dtmf-callback-for-multiple-tones"></a><h3>tp_cli_channel_interface_dtmf_callback_for_multiple_tones ()</h3>
 
2471
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_channel_interface_dtmf_callback_for_multiple_tones)
 
2472
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
2473
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 
2474
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2475
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
 
2476
<p>
 
2477
Signature of the callback called when a MultipleTones method call
 
2478
succeeds or fails.
 
2479
</p>
 
2480
<div class="variablelist"><table border="0">
 
2481
<col align="left" valign="top">
 
2482
<tbody>
 
2483
<tr>
 
2484
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
2485
<td>the proxy on which the call was made
 
2486
</td>
 
2487
</tr>
 
2488
<tr>
 
2489
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
2490
<td>
 
2491
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on success, or an error on failure
 
2492
</td>
 
2493
</tr>
 
2494
<tr>
 
2495
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
2496
<td>user-supplied data
 
2497
</td>
 
2498
</tr>
 
2499
<tr>
 
2500
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
2501
<td>user-supplied object
 
2502
</td>
 
2503
</tr>
 
2504
</tbody>
 
2505
</table></div>
 
2506
</div>
 
2507
<hr>
 
2508
<div class="refsect2" title="tp_cli_channel_interface_dtmf_connect_to_sending_tones ()">
 
2509
<a name="tp-cli-channel-interface-dtmf-connect-to-sending-tones"></a><h3>tp_cli_channel_interface_dtmf_connect_to_sending_tones ()</h3>
 
2510
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_channel_interface_dtmf_connect_to_sending_tones
 
2511
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
2512
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-signal-callback-sending-tones" title="tp_cli_channel_interface_dtmf_signal_callback_sending_tones ()"><span class="type">tp_cli_channel_interface_dtmf_signal_callback_sending_tones</span></a> callback</code></em>,
 
2513
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2514
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
2515
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
2516
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
2517
<p>
 
2518
Connect a handler to the signal SendingTones.
 
2519
</p>
 
2520
<p>
 
2521
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;DTMF tone(s)are being sent to all eligible streams in the channel.         The signal is provided to indicating the fact that the streams are         currently being used to send one or more DTMF tones, so any other         media input is not getting through to the audio stream. It also         serves as a cue for the         &lt;tp:member-ref&gt;StopTone&lt;/tp:member-ref&gt; method.&lt;/p&gt;
 
2522
</p>
 
2523
<div class="variablelist"><table border="0">
 
2524
<col align="left" valign="top">
 
2525
<tbody>
 
2526
<tr>
 
2527
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
2528
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass
 
2529
</td>
 
2530
</tr>
 
2531
<tr>
 
2532
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
2533
<td>Callback to be called when the signal is
 
2534
  received
 
2535
</td>
 
2536
</tr>
 
2537
<tr>
 
2538
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
2539
<td>User-supplied data for the callback
 
2540
</td>
 
2541
</tr>
 
2542
<tr>
 
2543
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
 
2544
<td>Destructor for the user-supplied data, which
 
2545
  will be called when this signal is disconnected, or
 
2546
  before this function returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
2547
</td>
 
2548
</tr>
 
2549
<tr>
 
2550
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
2551
<td>A <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced; 
 
2552
  if it is destroyed, this callback will automatically be
 
2553
  disconnected
 
2554
</td>
 
2555
</tr>
 
2556
<tr>
 
2557
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
2558
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
 
2559
  returned
 
2560
</td>
 
2561
</tr>
 
2562
<tr>
 
2563
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
2564
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
 
2565
above, which can be used to disconnect the signal; or
 
2566
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
 
2567
or has become invalid.
 
2568
</td>
 
2569
</tr>
 
2570
</tbody>
 
2571
</table></div>
 
2572
</div>
 
2573
<hr>
 
2574
<div class="refsect2" title="tp_cli_channel_interface_dtmf_signal_callback_sending_tones ()">
 
2575
<a name="tp-cli-channel-interface-dtmf-signal-callback-sending-tones"></a><h3>tp_cli_channel_interface_dtmf_signal_callback_sending_tones ()</h3>
 
2576
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_channel_interface_dtmf_signal_callback_sending_tones)
 
2577
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
2578
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *arg_Tones</code></em>,
 
2579
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2580
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
 
2581
<p>
 
2582
Represents the signature of a callback for the signal SendingTones.
 
2583
</p>
 
2584
<div class="variablelist"><table border="0">
 
2585
<col align="left" valign="top">
 
2586
<tbody>
 
2587
<tr>
 
2588
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
2589
<td>The proxy on which <a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-connect-to-sending-tones" title="tp_cli_channel_interface_dtmf_connect_to_sending_tones ()"><code class="function">tp_cli_channel_interface_dtmf_connect_to_sending_tones()</code></a>
 
2590
 was called
 
2591
</td>
 
2592
</tr>
 
2593
<tr>
 
2594
<td><p><span class="term"><em class="parameter"><code>arg_Tones</code></em> :</span></p></td>
 
2595
<td>DTMF string (one or more events) that is to be played.
 
2596
</td>
 
2597
</tr>
 
2598
<tr>
 
2599
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
2600
<td>User-supplied data
 
2601
</td>
 
2602
</tr>
 
2603
<tr>
 
2604
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
2605
<td>User-supplied weakly referenced object
 
2606
</td>
 
2607
</tr>
 
2608
</tbody>
 
2609
</table></div>
 
2610
</div>
 
2611
<hr>
 
2612
<div class="refsect2" title="tp_cli_channel_interface_dtmf_connect_to_stopped_tones ()">
 
2613
<a name="tp-cli-channel-interface-dtmf-connect-to-stopped-tones"></a><h3>tp_cli_channel_interface_dtmf_connect_to_stopped_tones ()</h3>
 
2614
<pre class="programlisting"><a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="returnvalue">TpProxySignalConnection</span></a> * tp_cli_channel_interface_dtmf_connect_to_stopped_tones
 
2615
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
2616
                                                         <em class="parameter"><code><a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-signal-callback-stopped-tones" title="tp_cli_channel_interface_dtmf_signal_callback_stopped_tones ()"><span class="type">tp_cli_channel_interface_dtmf_signal_callback_stopped_tones</span></a> callback</code></em>,
 
2617
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2618
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>,
 
2619
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>,
 
2620
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
2621
<p>
 
2622
Connect a handler to the signal StoppedTones.
 
2623
</p>
 
2624
<p>
 
2625
&lt;tp:docstring xmlns="http://www.w3.org/1999/xhtml"&gt;         &lt;p&gt;DTMF tones have finished playing on streams in this channel.&lt;/p&gt;
 
2626
</p>
 
2627
<div class="variablelist"><table border="0">
 
2628
<col align="left" valign="top">
 
2629
<tbody>
 
2630
<tr>
 
2631
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
2632
<td>A <a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> or subclass
 
2633
</td>
 
2634
</tr>
 
2635
<tr>
 
2636
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
2637
<td>Callback to be called when the signal is
 
2638
  received
 
2639
</td>
 
2640
</tr>
 
2641
<tr>
 
2642
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
2643
<td>User-supplied data for the callback
 
2644
</td>
 
2645
</tr>
 
2646
<tr>
 
2647
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
 
2648
<td>Destructor for the user-supplied data, which
 
2649
  will be called when this signal is disconnected, or
 
2650
  before this function returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
2651
</td>
 
2652
</tr>
 
2653
<tr>
 
2654
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
2655
<td>A <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> which will be weakly referenced; 
 
2656
  if it is destroyed, this callback will automatically be
 
2657
  disconnected
 
2658
</td>
 
2659
</tr>
 
2660
<tr>
 
2661
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
2662
<td>If not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, used to raise an error if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is
 
2663
  returned
 
2664
</td>
 
2665
</tr>
 
2666
<tr>
 
2667
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
2668
<td> a <a class="link" href="telepathy-glib-proxy.html#TpProxySignalConnection" title="TpProxySignalConnection"><span class="type">TpProxySignalConnection</span></a> containing all of the
 
2669
above, which can be used to disconnect the signal; or
 
2670
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the proxy does not have the desired interface
 
2671
or has become invalid.
 
2672
</td>
 
2673
</tr>
 
2674
</tbody>
 
2675
</table></div>
 
2676
</div>
 
2677
<hr>
 
2678
<div class="refsect2" title="tp_cli_channel_interface_dtmf_signal_callback_stopped_tones ()">
 
2679
<a name="tp-cli-channel-interface-dtmf-signal-callback-stopped-tones"></a><h3>tp_cli_channel_interface_dtmf_signal_callback_stopped_tones ()</h3>
 
2680
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_channel_interface_dtmf_signal_callback_stopped_tones)
 
2681
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-channel.html#TpChannel"><span class="type">TpChannel</span></a> *proxy</code></em>,
 
2682
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> arg_Cancelled</code></em>,
 
2683
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 
2684
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *weak_object</code></em>);</pre>
 
2685
<p>
 
2686
Represents the signature of a callback for the signal StoppedTones.
 
2687
</p>
 
2688
<div class="variablelist"><table border="0">
 
2689
<col align="left" valign="top">
 
2690
<tbody>
 
2691
<tr>
 
2692
<td><p><span class="term"><em class="parameter"><code>proxy</code></em> :</span></p></td>
 
2693
<td>The proxy on which <a class="link" href="telepathy-glib-channel-media.html#tp-cli-channel-interface-dtmf-connect-to-stopped-tones" title="tp_cli_channel_interface_dtmf_connect_to_stopped_tones ()"><code class="function">tp_cli_channel_interface_dtmf_connect_to_stopped_tones()</code></a>
 
2694
 was called
 
2695
</td>
 
2696
</tr>
 
2697
<tr>
 
2698
<td><p><span class="term"><em class="parameter"><code>arg_Cancelled</code></em> :</span></p></td>
 
2699
<td>True if the DTMF tones were actively cancelled via           &lt;tp:member-ref&gt;StopTone&lt;/tp:member-ref&gt;.
 
2700
</td>
 
2701
</tr>
 
2702
<tr>
 
2703
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
2704
<td>User-supplied data
 
2705
</td>
 
2706
</tr>
 
2707
<tr>
 
2708
<td><p><span class="term"><em class="parameter"><code>weak_object</code></em> :</span></p></td>
 
2709
<td>User-supplied weakly referenced object
 
2710
</td>
 
2711
</tr>
 
2712
</tbody>
 
2713
</table></div>
 
2714
</div>
 
2715
<hr>
2357
2716
<div class="refsect2" title="tp_cli_channel_interface_hold_callback_for_get_hold_state ()">
2358
2717
<a name="tp-cli-channel-interface-hold-callback-for-get-hold-state"></a><h3>tp_cli_channel_interface_hold_callback_for_get_hold_state ()</h3>
2359
2718
<pre class="programlisting"><span class="returnvalue">void</span>                (*tp_cli_channel_interface_hold_callback_for_get_hold_state)
3127
3486
</div>
3128
3487
<div class="footer">
3129
3488
<hr>
3130
 
          Generated by GTK-Doc V1.14</div>
 
3489
          Generated by GTK-Doc V1.15</div>
3131
3490
</body>
3132
3491
</html>
 
 
b'\\ No newline at end of file'