33
30
<h2><span class="refentrytitle"><a name="gst-plugins-base-libs-gstrtspconnection.top_of_page"></a>gstrtspconnection</span></h2>
34
31
<p>gstrtspconnection — manage RTSP connections</p>
36
<td valign="top" align="right"></td>
33
<td class="gallery_image" valign="top" align="right"></td>
37
34
</tr></table></div>
38
<div class="refsynopsisdiv">
39
<a name="gst-plugins-base-libs-gstrtspconnection.synopsis"></a><h2>Synopsis</h2>
40
<pre class="synopsis">
41
#include <gst/rtsp/gstrtspconnection.h>
43
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection">GstRTSPConnection</a>;
44
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-create" title="gst_rtsp_connection_create ()">gst_rtsp_connection_create</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>,
45
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> **conn</code></em>);
46
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-create-from-socket" title="gst_rtsp_connection_create_from_socket ()">gst_rtsp_connection_create_from_socket</a>
47
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="type">GSocket</span></a> *socket</code></em>,
48
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ip</code></em>,
49
<em class="parameter"><code><span class="type">guint16</span> port</code></em>,
50
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *initial_buffer</code></em>,
51
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> **conn</code></em>);
52
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-accept" title="gst_rtsp_connection_accept ()">gst_rtsp_connection_accept</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="type">GSocket</span></a> *socket</code></em>,
53
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> **conn</code></em>,
54
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>);
55
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-connect" title="gst_rtsp_connection_connect ()">gst_rtsp_connection_connect</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
56
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);
57
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-close" title="gst_rtsp_connection_close ()">gst_rtsp_connection_close</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
58
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-free" title="gst_rtsp_connection_free ()">gst_rtsp_connection_free</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
59
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-read" title="gst_rtsp_connection_read ()">gst_rtsp_connection_read</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
60
<em class="parameter"><code><span class="type">guint8</span> *data</code></em>,
61
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>,
62
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);
63
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-write" title="gst_rtsp_connection_write ()">gst_rtsp_connection_write</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
64
<em class="parameter"><code>const <span class="type">guint8</span> *data</code></em>,
65
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>,
66
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);
67
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-poll" title="gst_rtsp_connection_poll ()">gst_rtsp_connection_poll</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
68
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPEvent" title="enum GstRTSPEvent"><span class="type">GstRTSPEvent</span></a> events</code></em>,
69
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPEvent" title="enum GstRTSPEvent"><span class="type">GstRTSPEvent</span></a> *revents</code></em>,
70
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);
71
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-send" title="gst_rtsp_connection_send ()">gst_rtsp_connection_send</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
72
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspmessage.html#GstRTSPMessage" title="struct GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>,
73
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);
74
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-receive" title="gst_rtsp_connection_receive ()">gst_rtsp_connection_receive</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
75
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspmessage.html#GstRTSPMessage" title="struct GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>,
76
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);
77
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-next-timeout" title="gst_rtsp_connection_next_timeout ()">gst_rtsp_connection_next_timeout</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
78
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);
79
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-reset-timeout" title="gst_rtsp_connection_reset_timeout ()">gst_rtsp_connection_reset_timeout</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
80
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()">gst_rtsp_connection_flush</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
81
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> flush</code></em>);
82
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-auth" title="gst_rtsp_connection_set_auth ()">gst_rtsp_connection_set_auth</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
83
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPAuthMethod" title="enum GstRTSPAuthMethod"><span class="type">GstRTSPAuthMethod</span></a> method</code></em>,
84
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *user</code></em>,
85
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pass</code></em>);
86
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-auth-param" title="gst_rtsp_connection_set_auth_param ()">gst_rtsp_connection_set_auth_param</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
87
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *param</code></em>,
88
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
89
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-clear-auth-params" title="gst_rtsp_connection_clear_auth_params ()">gst_rtsp_connection_clear_auth_params</a>
90
(<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
91
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-qos-dscp" title="gst_rtsp_connection_set_qos_dscp ()">gst_rtsp_connection_set_qos_dscp</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
92
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> qos_dscp</code></em>);
93
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-ip" title="gst_rtsp_connection_set_ip ()">gst_rtsp_connection_set_ip</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
94
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ip</code></em>);
95
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-ip" title="gst_rtsp_connection_get_ip ()">gst_rtsp_connection_get_ip</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
96
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-url" title="gst_rtsp_connection_get_url ()">gst_rtsp_connection_get_url</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
97
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-tunneled" title="gst_rtsp_connection_set_tunneled ()">gst_rtsp_connection_set_tunneled</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
98
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> tunneled</code></em>);
99
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-is-tunneled" title="gst_rtsp_connection_is_tunneled ()">gst_rtsp_connection_is_tunneled</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
100
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-tunnelid" title="gst_rtsp_connection_get_tunnelid ()">gst_rtsp_connection_get_tunnelid</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
101
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-do-tunnel" title="gst_rtsp_connection_do_tunnel ()">gst_rtsp_connection_do_tunnel</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
102
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn2</code></em>);
103
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-http-mode" title="gst_rtsp_connection_set_http_mode ()">gst_rtsp_connection_set_http_mode</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
104
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable</code></em>);
105
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-proxy" title="gst_rtsp_connection_set_proxy ()">gst_rtsp_connection_set_proxy</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
106
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host</code></em>,
107
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> port</code></em>);
108
<a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="returnvalue">GSocket</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-read-socket" title="gst_rtsp_connection_get_read_socket ()">gst_rtsp_connection_get_read_socket</a> (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
109
<a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="returnvalue">GSocket</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-write-socket" title="gst_rtsp_connection_get_write_socket ()">gst_rtsp_connection_get_write_socket</a>
110
(<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
111
<a href="http://library.gnome.org/devel/gio/unstable/GTlsConnection.html"><span class="returnvalue">GTlsConnection</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-tls" title="gst_rtsp_connection_get_tls ()">gst_rtsp_connection_get_tls</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
112
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
113
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-tls-validation-flags" title="gst_rtsp_connection_set_tls_validation_flags ()">gst_rtsp_connection_set_tls_validation_flags</a>
114
(<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
115
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> flags</code></em>);
116
<a href="http://library.gnome.org/devel/gio/unstable/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-tls-validation-flags" title="gst_rtsp_connection_get_tls_validation_flags ()">gst_rtsp_connection_get_tls_validation_flags</a>
117
(<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);
118
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch">GstRTSPWatch</a>;
119
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatchFuncs" title="GstRTSPWatchFuncs">GstRTSPWatchFuncs</a>;
120
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="returnvalue">GstRTSPWatch</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-new" title="gst_rtsp_watch_new ()">gst_rtsp_watch_new</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
121
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatchFuncs" title="GstRTSPWatchFuncs"><span class="type">GstRTSPWatchFuncs</span></a> *funcs</code></em>,
122
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
123
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);
124
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-unref" title="gst_rtsp_watch_unref ()">gst_rtsp_watch_unref</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>);
125
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-attach" title="gst_rtsp_watch_attach ()">gst_rtsp_watch_attach</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
126
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>);
127
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-reset" title="gst_rtsp_watch_reset ()">gst_rtsp_watch_reset</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>);
128
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-send-message" title="gst_rtsp_watch_send_message ()">gst_rtsp_watch_send_message</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
129
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspmessage.html#GstRTSPMessage" title="struct GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>,
130
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *id</code></em>);
131
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-write-data" title="gst_rtsp_watch_write_data ()">gst_rtsp_watch_write_data</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
132
<em class="parameter"><code>const <span class="type">guint8</span> *data</code></em>,
133
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>,
134
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *id</code></em>);
135
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-get-send-backlog" title="gst_rtsp_watch_get_send_backlog ()">gst_rtsp_watch_get_send_backlog</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
136
<em class="parameter"><code><span class="type">gsize</span> *bytes</code></em>,
137
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *messages</code></em>);
138
<span class="returnvalue">void</span> <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-set-send-backlog" title="gst_rtsp_watch_set_send_backlog ()">gst_rtsp_watch_set_send_backlog</a> (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
139
<em class="parameter"><code><span class="type">gsize</span> bytes</code></em>,
140
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> messages</code></em>);
35
<div class="refsect1">
36
<a name="gst-plugins-base-libs-gstrtspconnection.functions"></a><h2>Functions</h2>
37
<div class="informaltable"><table width="100%" border="0">
39
<col width="150px" class="functions_return">
40
<col class="functions_name">
44
<td class="function_type">
45
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
47
<td class="function_name">
48
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-create" title="gst_rtsp_connection_create ()">gst_rtsp_connection_create</a> <span class="c_punctuation">()</span>
52
<td class="function_type">
53
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
55
<td class="function_name">
56
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-create-from-socket" title="gst_rtsp_connection_create_from_socket ()">gst_rtsp_connection_create_from_socket</a> <span class="c_punctuation">()</span>
60
<td class="function_type">
61
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
63
<td class="function_name">
64
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-accept" title="gst_rtsp_connection_accept ()">gst_rtsp_connection_accept</a> <span class="c_punctuation">()</span>
68
<td class="function_type">
69
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
71
<td class="function_name">
72
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-connect" title="gst_rtsp_connection_connect ()">gst_rtsp_connection_connect</a> <span class="c_punctuation">()</span>
76
<td class="function_type">
77
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
79
<td class="function_name">
80
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-close" title="gst_rtsp_connection_close ()">gst_rtsp_connection_close</a> <span class="c_punctuation">()</span>
84
<td class="function_type">
85
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
87
<td class="function_name">
88
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-free" title="gst_rtsp_connection_free ()">gst_rtsp_connection_free</a> <span class="c_punctuation">()</span>
92
<td class="function_type">
93
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
95
<td class="function_name">
96
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-read" title="gst_rtsp_connection_read ()">gst_rtsp_connection_read</a> <span class="c_punctuation">()</span>
100
<td class="function_type">
101
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
103
<td class="function_name">
104
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-write" title="gst_rtsp_connection_write ()">gst_rtsp_connection_write</a> <span class="c_punctuation">()</span>
108
<td class="function_type">
109
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
111
<td class="function_name">
112
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-poll" title="gst_rtsp_connection_poll ()">gst_rtsp_connection_poll</a> <span class="c_punctuation">()</span>
116
<td class="function_type">
117
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
119
<td class="function_name">
120
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-send" title="gst_rtsp_connection_send ()">gst_rtsp_connection_send</a> <span class="c_punctuation">()</span>
124
<td class="function_type">
125
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
127
<td class="function_name">
128
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-receive" title="gst_rtsp_connection_receive ()">gst_rtsp_connection_receive</a> <span class="c_punctuation">()</span>
132
<td class="function_type">
133
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
135
<td class="function_name">
136
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-next-timeout" title="gst_rtsp_connection_next_timeout ()">gst_rtsp_connection_next_timeout</a> <span class="c_punctuation">()</span>
140
<td class="function_type">
141
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
143
<td class="function_name">
144
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-reset-timeout" title="gst_rtsp_connection_reset_timeout ()">gst_rtsp_connection_reset_timeout</a> <span class="c_punctuation">()</span>
148
<td class="function_type">
149
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
151
<td class="function_name">
152
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()">gst_rtsp_connection_flush</a> <span class="c_punctuation">()</span>
156
<td class="function_type">
157
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
159
<td class="function_name">
160
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-auth" title="gst_rtsp_connection_set_auth ()">gst_rtsp_connection_set_auth</a> <span class="c_punctuation">()</span>
164
<td class="function_type">
165
<span class="returnvalue">void</span>
167
<td class="function_name">
168
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-auth-param" title="gst_rtsp_connection_set_auth_param ()">gst_rtsp_connection_set_auth_param</a> <span class="c_punctuation">()</span>
172
<td class="function_type">
173
<span class="returnvalue">void</span>
175
<td class="function_name">
176
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-clear-auth-params" title="gst_rtsp_connection_clear_auth_params ()">gst_rtsp_connection_clear_auth_params</a> <span class="c_punctuation">()</span>
180
<td class="function_type">
181
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
183
<td class="function_name">
184
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-qos-dscp" title="gst_rtsp_connection_set_qos_dscp ()">gst_rtsp_connection_set_qos_dscp</a> <span class="c_punctuation">()</span>
188
<td class="function_type">
189
<span class="returnvalue">void</span>
191
<td class="function_name">
192
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-ip" title="gst_rtsp_connection_set_ip ()">gst_rtsp_connection_set_ip</a> <span class="c_punctuation">()</span>
196
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
198
<td class="function_name">
199
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-ip" title="gst_rtsp_connection_get_ip ()">gst_rtsp_connection_get_ip</a> <span class="c_punctuation">()</span>
203
<td class="function_type">
204
<a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> *
206
<td class="function_name">
207
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-url" title="gst_rtsp_connection_get_url ()">gst_rtsp_connection_get_url</a> <span class="c_punctuation">()</span>
211
<td class="function_type">
212
<span class="returnvalue">void</span>
214
<td class="function_name">
215
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-tunneled" title="gst_rtsp_connection_set_tunneled ()">gst_rtsp_connection_set_tunneled</a> <span class="c_punctuation">()</span>
219
<td class="function_type">
220
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
222
<td class="function_name">
223
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-is-tunneled" title="gst_rtsp_connection_is_tunneled ()">gst_rtsp_connection_is_tunneled</a> <span class="c_punctuation">()</span>
227
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
229
<td class="function_name">
230
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-tunnelid" title="gst_rtsp_connection_get_tunnelid ()">gst_rtsp_connection_get_tunnelid</a> <span class="c_punctuation">()</span>
234
<td class="function_type">
235
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
237
<td class="function_name">
238
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-do-tunnel" title="gst_rtsp_connection_do_tunnel ()">gst_rtsp_connection_do_tunnel</a> <span class="c_punctuation">()</span>
242
<td class="function_type">
243
<span class="returnvalue">void</span>
245
<td class="function_name">
246
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-http-mode" title="gst_rtsp_connection_set_http_mode ()">gst_rtsp_connection_set_http_mode</a> <span class="c_punctuation">()</span>
250
<td class="function_type">
251
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
253
<td class="function_name">
254
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-proxy" title="gst_rtsp_connection_set_proxy ()">gst_rtsp_connection_set_proxy</a> <span class="c_punctuation">()</span>
258
<td class="function_type">
259
<a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="returnvalue">GSocket</span></a> *
261
<td class="function_name">
262
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-read-socket" title="gst_rtsp_connection_get_read_socket ()">gst_rtsp_connection_get_read_socket</a> <span class="c_punctuation">()</span>
266
<td class="function_type">
267
<a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="returnvalue">GSocket</span></a> *
269
<td class="function_name">
270
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-write-socket" title="gst_rtsp_connection_get_write_socket ()">gst_rtsp_connection_get_write_socket</a> <span class="c_punctuation">()</span>
274
<td class="function_type">
275
<a href="http://library.gnome.org/devel/gio/unstable/GTlsConnection.html"><span class="returnvalue">GTlsConnection</span></a> *
277
<td class="function_name">
278
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-tls" title="gst_rtsp_connection_get_tls ()">gst_rtsp_connection_get_tls</a> <span class="c_punctuation">()</span>
282
<td class="function_type">
283
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
285
<td class="function_name">
286
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-set-tls-validation-flags" title="gst_rtsp_connection_set_tls_validation_flags ()">gst_rtsp_connection_set_tls_validation_flags</a> <span class="c_punctuation">()</span>
290
<td class="function_type">
291
<a href="http://library.gnome.org/devel/gio/unstable/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a>
293
<td class="function_name">
294
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-get-tls-validation-flags" title="gst_rtsp_connection_get_tls_validation_flags ()">gst_rtsp_connection_get_tls_validation_flags</a> <span class="c_punctuation">()</span>
298
<td class="function_type">
299
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="returnvalue">GstRTSPWatch</span></a> *
301
<td class="function_name">
302
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-new" title="gst_rtsp_watch_new ()">gst_rtsp_watch_new</a> <span class="c_punctuation">()</span>
306
<td class="function_type">
307
<span class="returnvalue">void</span>
309
<td class="function_name">
310
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-unref" title="gst_rtsp_watch_unref ()">gst_rtsp_watch_unref</a> <span class="c_punctuation">()</span>
314
<td class="function_type">
315
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
317
<td class="function_name">
318
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-attach" title="gst_rtsp_watch_attach ()">gst_rtsp_watch_attach</a> <span class="c_punctuation">()</span>
322
<td class="function_type">
323
<span class="returnvalue">void</span>
325
<td class="function_name">
326
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-reset" title="gst_rtsp_watch_reset ()">gst_rtsp_watch_reset</a> <span class="c_punctuation">()</span>
330
<td class="function_type">
331
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
333
<td class="function_name">
334
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-send-message" title="gst_rtsp_watch_send_message ()">gst_rtsp_watch_send_message</a> <span class="c_punctuation">()</span>
338
<td class="function_type">
339
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
341
<td class="function_name">
342
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-write-data" title="gst_rtsp_watch_write_data ()">gst_rtsp_watch_write_data</a> <span class="c_punctuation">()</span>
346
<td class="function_type">
347
<span class="returnvalue">void</span>
349
<td class="function_name">
350
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-get-send-backlog" title="gst_rtsp_watch_get_send_backlog ()">gst_rtsp_watch_get_send_backlog</a> <span class="c_punctuation">()</span>
354
<td class="function_type">
355
<span class="returnvalue">void</span>
357
<td class="function_name">
358
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-set-send-backlog" title="gst_rtsp_watch_set_send_backlog ()">gst_rtsp_watch_set_send_backlog</a> <span class="c_punctuation">()</span>
364
<div class="refsect1">
365
<a name="gst-plugins-base-libs-gstrtspconnection.other"></a><h2>Types and Values</h2>
366
<div class="informaltable"><table width="100%" border="0">
368
<col width="150px" class="name">
369
<col class="description">
373
<td class="datatype_keyword"> </td>
374
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection">GstRTSPConnection</a></td>
377
<td class="datatype_keyword"> </td>
378
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch">GstRTSPWatch</a></td>
381
<td class="datatype_keyword"> </td>
382
<td class="function_name"><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatchFuncs" title="GstRTSPWatchFuncs">GstRTSPWatchFuncs</a></td>
387
<div class="refsect1">
388
<a name="gst-plugins-base-libs-gstrtspconnection.object-hierarchy"></a><h2>Object Hierarchy</h2>
392
<div class="refsect1">
393
<a name="gst-plugins-base-libs-gstrtspconnection.includes"></a><h2>Includes</h2>
394
<pre class="synopsis">#include <gst/rtsp/gstrtspconnection.h>
143
397
<div class="refsect1">
144
398
<a name="gst-plugins-base-libs-gstrtspconnection.description"></a><h2>Description</h2>
146
This object manages the RTSP connection to the server. It provides function
147
to receive and send bytes and messages.
149
Last reviewed on 2007-07-24 (0.10.14)
399
<p>This object manages the RTSP connection to the server. It provides function
400
to receive and send bytes and messages.</p>
401
<p>Last reviewed on 2007-07-24 (0.10.14)</p>
152
403
<div class="refsect1">
153
<a name="gst-plugins-base-libs-gstrtspconnection.details"></a><h2>Details</h2>
154
<div class="refsect2">
155
<a name="GstRTSPConnection"></a><h3>GstRTSPConnection</h3>
156
<pre class="programlisting">typedef struct _GstRTSPConnection GstRTSPConnection;</pre>
158
Opaque RTSP connection object.
162
<div class="refsect2">
163
<a name="gst-rtsp-connection-create"></a><h3>gst_rtsp_connection_create ()</h3>
164
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_create (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>,
165
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> **conn</code></em>);</pre>
167
Create a newly allocated <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> from <em class="parameter"><code>url</code></em> and store it in <em class="parameter"><code>conn</code></em>.
168
The connection will not yet attempt to connect to <em class="parameter"><code>url</code></em>, use
169
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-connect" title="gst_rtsp_connection_connect ()"><code class="function">gst_rtsp_connection_connect()</code></a>.
172
A copy of <em class="parameter"><code>url</code></em> will be made.
174
<div class="variablelist"><table border="0" class="variablelist">
176
<col align="left" valign="top">
181
<td><p><span class="term"><em class="parameter"><code>url</code></em> :</span></p></td>
182
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a>
186
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
187
<td>storage for a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
191
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
193
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> when <em class="parameter"><code>conn</code></em> contains a valid connection.</td>
199
<div class="refsect2">
200
<a name="gst-rtsp-connection-create-from-socket"></a><h3>gst_rtsp_connection_create_from_socket ()</h3>
201
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_create_from_socket
202
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="type">GSocket</span></a> *socket</code></em>,
203
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ip</code></em>,
204
<em class="parameter"><code><span class="type">guint16</span> port</code></em>,
205
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *initial_buffer</code></em>,
206
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> **conn</code></em>);</pre>
208
Create a new <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> for handling communication on the existing
209
socket <em class="parameter"><code>socket</code></em>. The <em class="parameter"><code>initial_buffer</code></em> contains zero terminated data already
210
read from <em class="parameter"><code>socket</code></em> which should be used before starting to read new data.
212
<div class="variablelist"><table border="0" class="variablelist">
214
<col align="left" valign="top">
219
<td><p><span class="term"><em class="parameter"><code>socket</code></em> :</span></p></td>
220
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="type">GSocket</span></a>
224
<td><p><span class="term"><em class="parameter"><code>ip</code></em> :</span></p></td>
225
<td>the IP address of the other end</td>
228
<td><p><span class="term"><em class="parameter"><code>port</code></em> :</span></p></td>
229
<td>the port used by the other end</td>
232
<td><p><span class="term"><em class="parameter"><code>initial_buffer</code></em> :</span></p></td>
233
<td>data already read from <em class="parameter"><code>fd</code></em>
237
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
238
<td>storage for a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
242
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
244
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> when <em class="parameter"><code>conn</code></em> contains a valid connection.</td>
250
<div class="refsect2">
251
<a name="gst-rtsp-connection-accept"></a><h3>gst_rtsp_connection_accept ()</h3>
252
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_accept (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="type">GSocket</span></a> *socket</code></em>,
253
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> **conn</code></em>,
254
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>);</pre>
256
Accept a new connection on <em class="parameter"><code>socket</code></em> and create a new <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> for
257
handling communication on new socket.
259
<div class="variablelist"><table border="0" class="variablelist">
261
<col align="left" valign="top">
266
<td><p><span class="term"><em class="parameter"><code>socket</code></em> :</span></p></td>
270
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
271
<td>storage for a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
275
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
276
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> to cancel the operation</td>
279
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
281
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> when <em class="parameter"><code>conn</code></em> contains a valid connection.</td>
287
<div class="refsect2">
288
<a name="gst-rtsp-connection-connect"></a><h3>gst_rtsp_connection_connect ()</h3>
289
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_connect (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
290
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
292
Attempt to connect to the url of <em class="parameter"><code>conn</code></em> made with
293
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-create" title="gst_rtsp_connection_create ()"><code class="function">gst_rtsp_connection_create()</code></a>. If <em class="parameter"><code>timeout</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> this function can block
294
forever. If <em class="parameter"><code>timeout</code></em> contains a valid timeout, this function will return
295
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-ETIMEOUT:CAPS"><span class="type">GST_RTSP_ETIMEOUT</span></a> after the timeout expired.
298
This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.
300
<div class="variablelist"><table border="0" class="variablelist">
302
<col align="left" valign="top">
307
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
308
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
312
<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td>
313
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> timeout</td>
316
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
318
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> when a connection could be made.</td>
324
<div class="refsect2">
325
<a name="gst-rtsp-connection-close"></a><h3>gst_rtsp_connection_close ()</h3>
326
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_close (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
328
Close the connected <em class="parameter"><code>conn</code></em>. After this call, the connection is in the same
329
state as when it was first created.
331
<div class="variablelist"><table border="0" class="variablelist">
333
<col align="left" valign="top">
338
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
339
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
343
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
345
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</td>
351
<div class="refsect2">
352
<a name="gst-rtsp-connection-free"></a><h3>gst_rtsp_connection_free ()</h3>
353
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_free (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
355
Close and free <em class="parameter"><code>conn</code></em>.
357
<div class="variablelist"><table border="0" class="variablelist">
359
<col align="left" valign="top">
364
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
365
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
369
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
371
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</td>
377
<div class="refsect2">
378
<a name="gst-rtsp-connection-read"></a><h3>gst_rtsp_connection_read ()</h3>
379
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_read (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
380
<em class="parameter"><code><span class="type">guint8</span> *data</code></em>,
381
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>,
382
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
384
Attempt to read <em class="parameter"><code>size</code></em> bytes into <em class="parameter"><code>data</code></em> from the connected <em class="parameter"><code>conn</code></em>, blocking up to
385
the specified <em class="parameter"><code>timeout</code></em>. <em class="parameter"><code>timeout</code></em> can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function
389
This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.
391
<div class="variablelist"><table border="0" class="variablelist">
393
<col align="left" valign="top">
398
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
399
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
403
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
404
<td>the data to read</td>
407
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
408
<td>the size of <em class="parameter"><code>data</code></em>
412
<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td>
413
<td>a timeout value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>
417
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
419
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</td>
425
<div class="refsect2">
426
<a name="gst-rtsp-connection-write"></a><h3>gst_rtsp_connection_write ()</h3>
427
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_write (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
428
<em class="parameter"><code>const <span class="type">guint8</span> *data</code></em>,
429
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>,
430
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
432
Attempt to write <em class="parameter"><code>size</code></em> bytes of <em class="parameter"><code>data</code></em> to the connected <em class="parameter"><code>conn</code></em>, blocking up to
433
the specified <em class="parameter"><code>timeout</code></em>. <em class="parameter"><code>timeout</code></em> can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function
437
This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.
439
<div class="variablelist"><table border="0" class="variablelist">
441
<col align="left" valign="top">
446
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
447
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
451
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
452
<td>the data to write</td>
455
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
456
<td>the size of <em class="parameter"><code>data</code></em>
460
<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td>
461
<td>a timeout value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>
465
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
467
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</td>
473
<div class="refsect2">
474
<a name="gst-rtsp-connection-poll"></a><h3>gst_rtsp_connection_poll ()</h3>
475
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_poll (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
476
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPEvent" title="enum GstRTSPEvent"><span class="type">GstRTSPEvent</span></a> events</code></em>,
477
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPEvent" title="enum GstRTSPEvent"><span class="type">GstRTSPEvent</span></a> *revents</code></em>,
478
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
480
Wait up to the specified <em class="parameter"><code>timeout</code></em> for the connection to become available for
481
at least one of the operations specified in <em class="parameter"><code>events</code></em>. When the function returns
482
with <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>, <em class="parameter"><code>revents</code></em> will contain a bitmask of available operations on
483
<em class="parameter"><code>conn</code></em>.
486
<em class="parameter"><code>timeout</code></em> can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function might block forever.
489
This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.
491
<div class="variablelist"><table border="0" class="variablelist">
493
<col align="left" valign="top">
498
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
499
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
503
<td><p><span class="term"><em class="parameter"><code>events</code></em> :</span></p></td>
504
<td>a bitmask of <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPEvent" title="enum GstRTSPEvent"><span class="type">GstRTSPEvent</span></a> flags to check</td>
507
<td><p><span class="term"><em class="parameter"><code>revents</code></em> :</span></p></td>
508
<td>location for result flags</td>
511
<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td>
515
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
517
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</td>
523
<div class="refsect2">
524
<a name="gst-rtsp-connection-send"></a><h3>gst_rtsp_connection_send ()</h3>
525
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_send (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
526
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspmessage.html#GstRTSPMessage" title="struct GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>,
527
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
529
Attempt to send <em class="parameter"><code>message</code></em> to the connected <em class="parameter"><code>conn</code></em>, blocking up to
530
the specified <em class="parameter"><code>timeout</code></em>. <em class="parameter"><code>timeout</code></em> can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function
534
This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.
536
<div class="variablelist"><table border="0" class="variablelist">
538
<col align="left" valign="top">
543
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
544
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
548
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
549
<td>the message to send</td>
552
<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td>
553
<td>a timeout value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>
557
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
559
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</td>
565
<div class="refsect2">
566
<a name="gst-rtsp-connection-receive"></a><h3>gst_rtsp_connection_receive ()</h3>
567
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_receive (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
568
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspmessage.html#GstRTSPMessage" title="struct GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>,
569
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
571
Attempt to read into <em class="parameter"><code>message</code></em> from the connected <em class="parameter"><code>conn</code></em>, blocking up to
572
the specified <em class="parameter"><code>timeout</code></em>. <em class="parameter"><code>timeout</code></em> can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function
576
This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.
578
<div class="variablelist"><table border="0" class="variablelist">
580
<col align="left" valign="top">
585
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
586
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
590
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
591
<td>the message to read</td>
594
<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td>
595
<td>a timeout value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>
599
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
601
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</td>
607
<div class="refsect2">
608
<a name="gst-rtsp-connection-next-timeout"></a><h3>gst_rtsp_connection_next_timeout ()</h3>
609
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_next_timeout (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
610
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
612
Calculate the next timeout for <em class="parameter"><code>conn</code></em>, storing the result in <em class="parameter"><code>timeout</code></em>.
614
<div class="variablelist"><table border="0" class="variablelist">
616
<col align="left" valign="top">
621
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
622
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
626
<td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td>
630
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
632
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</td>
638
<div class="refsect2">
639
<a name="gst-rtsp-connection-reset-timeout"></a><h3>gst_rtsp_connection_reset_timeout ()</h3>
640
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_reset_timeout (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
642
Reset the timeout of <em class="parameter"><code>conn</code></em>.
644
<div class="variablelist"><table border="0" class="variablelist">
646
<col align="left" valign="top">
651
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
652
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
656
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
658
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</td>
664
<div class="refsect2">
665
<a name="gst-rtsp-connection-flush"></a><h3>gst_rtsp_connection_flush ()</h3>
666
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_flush (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
667
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> flush</code></em>);</pre>
669
Start or stop the flushing action on <em class="parameter"><code>conn</code></em>. When flushing, all current
670
and future actions on <em class="parameter"><code>conn</code></em> will return <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-EINTR:CAPS"><span class="type">GST_RTSP_EINTR</span></a> until the connection
671
is set to non-flushing mode again.
673
<div class="variablelist"><table border="0" class="variablelist">
675
<col align="left" valign="top">
680
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
681
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
685
<td><p><span class="term"><em class="parameter"><code>flush</code></em> :</span></p></td>
686
<td>start or stop the flush</td>
689
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
691
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</td>
697
<div class="refsect2">
698
<a name="gst-rtsp-connection-set-auth"></a><h3>gst_rtsp_connection_set_auth ()</h3>
699
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_set_auth (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
700
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPAuthMethod" title="enum GstRTSPAuthMethod"><span class="type">GstRTSPAuthMethod</span></a> method</code></em>,
701
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *user</code></em>,
702
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pass</code></em>);</pre>
704
Configure <em class="parameter"><code>conn</code></em> for authentication mode <em class="parameter"><code>method</code></em> with <em class="parameter"><code>user</code></em> and <em class="parameter"><code>pass</code></em> as the
705
user and password respectively.
707
<div class="variablelist"><table border="0" class="variablelist">
709
<col align="left" valign="top">
714
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
715
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
719
<td><p><span class="term"><em class="parameter"><code>method</code></em> :</span></p></td>
720
<td>authentication method</td>
723
<td><p><span class="term"><em class="parameter"><code>user</code></em> :</span></p></td>
727
<td><p><span class="term"><em class="parameter"><code>pass</code></em> :</span></p></td>
728
<td>the password</td>
731
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
733
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</td>
739
<div class="refsect2">
740
<a name="gst-rtsp-connection-set-auth-param"></a><h3>gst_rtsp_connection_set_auth_param ()</h3>
741
<pre class="programlisting"><span class="returnvalue">void</span> gst_rtsp_connection_set_auth_param (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
742
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *param</code></em>,
743
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
745
Setup <em class="parameter"><code>conn</code></em> with authentication directives. This is not necesary for
404
<a name="gst-plugins-base-libs-gstrtspconnection.functions_details"></a><h2>Functions</h2>
405
<div class="refsect2">
406
<a name="gst-rtsp-connection-create"></a><h3>gst_rtsp_connection_create ()</h3>
407
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
408
gst_rtsp_connection_create (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>,
409
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> **conn</code></em>);</pre>
410
<p>Create a newly allocated <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> from <em class="parameter"><code>url</code></em>
411
and store it in <em class="parameter"><code>conn</code></em>
413
The connection will not yet attempt to connect to <em class="parameter"><code>url</code></em>
415
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-connect" title="gst_rtsp_connection_connect ()"><code class="function">gst_rtsp_connection_connect()</code></a>.</p>
416
<p>A copy of <em class="parameter"><code>url</code></em>
418
<div class="refsect3">
419
<a name="id-1.2.10.3.8.2.6"></a><h4>Parameters</h4>
420
<div class="informaltable"><table width="100%" border="0">
422
<col width="150px" class="parameters_name">
423
<col class="parameters_description">
424
<col width="200px" class="parameters_annotations">
428
<td class="parameter_name"><p>url</p></td>
429
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> </p></td>
430
<td class="parameter_annotations"> </td>
433
<td class="parameter_name"><p>conn</p></td>
434
<td class="parameter_description"><p> storage for a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>. </p></td>
435
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
440
<div class="refsect3">
441
<a name="id-1.2.10.3.8.2.7"></a><h4>Returns</h4>
442
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> when <em class="parameter"><code>conn</code></em>
443
contains a valid connection.</p>
448
<div class="refsect2">
449
<a name="gst-rtsp-connection-create-from-socket"></a><h3>gst_rtsp_connection_create_from_socket ()</h3>
450
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
451
gst_rtsp_connection_create_from_socket
452
(<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="type">GSocket</span></a> *socket</code></em>,
453
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ip</code></em>,
454
<em class="parameter"><code><span class="type">guint16</span> port</code></em>,
455
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *initial_buffer</code></em>,
456
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> **conn</code></em>);</pre>
457
<p>Create a new <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> for handling communication on the existing
458
socket <em class="parameter"><code>socket</code></em>
459
. The <em class="parameter"><code>initial_buffer</code></em>
460
contains zero terminated data already
461
read from <em class="parameter"><code>socket</code></em>
462
which should be used before starting to read new data.</p>
463
<div class="refsect3">
464
<a name="id-1.2.10.3.8.3.5"></a><h4>Parameters</h4>
465
<div class="informaltable"><table width="100%" border="0">
467
<col width="150px" class="parameters_name">
468
<col class="parameters_description">
469
<col width="200px" class="parameters_annotations">
473
<td class="parameter_name"><p>socket</p></td>
474
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="type">GSocket</span></a></p></td>
475
<td class="parameter_annotations"> </td>
478
<td class="parameter_name"><p>ip</p></td>
479
<td class="parameter_description"><p>the IP address of the other end</p></td>
480
<td class="parameter_annotations"> </td>
483
<td class="parameter_name"><p>port</p></td>
484
<td class="parameter_description"><p>the port used by the other end</p></td>
485
<td class="parameter_annotations"> </td>
488
<td class="parameter_name"><p>initial_buffer</p></td>
489
<td class="parameter_description"><p>data already read from <em class="parameter"><code>fd</code></em>
491
<td class="parameter_annotations"> </td>
494
<td class="parameter_name"><p>conn</p></td>
495
<td class="parameter_description"><p> storage for a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>. </p></td>
496
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
501
<div class="refsect3">
502
<a name="id-1.2.10.3.8.3.6"></a><h4>Returns</h4>
503
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> when <em class="parameter"><code>conn</code></em>
504
contains a valid connection.</p>
509
<div class="refsect2">
510
<a name="gst-rtsp-connection-accept"></a><h3>gst_rtsp_connection_accept ()</h3>
511
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
512
gst_rtsp_connection_accept (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="type">GSocket</span></a> *socket</code></em>,
513
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> **conn</code></em>,
514
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>);</pre>
515
<p>Accept a new connection on <em class="parameter"><code>socket</code></em>
516
and create a new <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> for
517
handling communication on new socket.</p>
518
<div class="refsect3">
519
<a name="id-1.2.10.3.8.4.5"></a><h4>Parameters</h4>
520
<div class="informaltable"><table width="100%" border="0">
522
<col width="150px" class="parameters_name">
523
<col class="parameters_description">
524
<col width="200px" class="parameters_annotations">
528
<td class="parameter_name"><p>socket</p></td>
529
<td class="parameter_description"><p>a socket</p></td>
530
<td class="parameter_annotations"> </td>
533
<td class="parameter_name"><p>conn</p></td>
534
<td class="parameter_description"><p> storage for a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>. </p></td>
535
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
538
<td class="parameter_name"><p>cancellable</p></td>
539
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> to cancel the operation</p></td>
540
<td class="parameter_annotations"> </td>
545
<div class="refsect3">
546
<a name="id-1.2.10.3.8.4.6"></a><h4>Returns</h4>
547
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> when <em class="parameter"><code>conn</code></em>
548
contains a valid connection.</p>
553
<div class="refsect2">
554
<a name="gst-rtsp-connection-connect"></a><h3>gst_rtsp_connection_connect ()</h3>
555
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
556
gst_rtsp_connection_connect (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
557
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
558
<p>Attempt to connect to the url of <em class="parameter"><code>conn</code></em>
560
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-create" title="gst_rtsp_connection_create ()"><code class="function">gst_rtsp_connection_create()</code></a>. If <em class="parameter"><code>timeout</code></em>
561
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> this function can block
562
forever. If <em class="parameter"><code>timeout</code></em>
563
contains a valid timeout, this function will return
564
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-ETIMEOUT:CAPS"><span class="type">GST_RTSP_ETIMEOUT</span></a> after the timeout expired.</p>
565
<p>This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.</p>
566
<div class="refsect3">
567
<a name="id-1.2.10.3.8.5.6"></a><h4>Parameters</h4>
568
<div class="informaltable"><table width="100%" border="0">
570
<col width="150px" class="parameters_name">
571
<col class="parameters_description">
572
<col width="200px" class="parameters_annotations">
576
<td class="parameter_name"><p>conn</p></td>
577
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> </p></td>
578
<td class="parameter_annotations"> </td>
581
<td class="parameter_name"><p>timeout</p></td>
582
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> timeout</p></td>
583
<td class="parameter_annotations"> </td>
588
<div class="refsect3">
589
<a name="id-1.2.10.3.8.5.7"></a><h4>Returns</h4>
590
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> when a connection could be made.</p>
595
<div class="refsect2">
596
<a name="gst-rtsp-connection-close"></a><h3>gst_rtsp_connection_close ()</h3>
597
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
598
gst_rtsp_connection_close (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
599
<p>Close the connected <em class="parameter"><code>conn</code></em>
600
. After this call, the connection is in the same
601
state as when it was first created.</p>
602
<div class="refsect3">
603
<a name="id-1.2.10.3.8.6.5"></a><h4>Parameters</h4>
604
<div class="informaltable"><table width="100%" border="0">
606
<col width="150px" class="parameters_name">
607
<col class="parameters_description">
608
<col width="200px" class="parameters_annotations">
611
<td class="parameter_name"><p>conn</p></td>
612
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
613
<td class="parameter_annotations"> </td>
617
<div class="refsect3">
618
<a name="id-1.2.10.3.8.6.6"></a><h4>Returns</h4>
619
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</p>
624
<div class="refsect2">
625
<a name="gst-rtsp-connection-free"></a><h3>gst_rtsp_connection_free ()</h3>
626
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
627
gst_rtsp_connection_free (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
628
<p>Close and free <em class="parameter"><code>conn</code></em>
630
<div class="refsect3">
631
<a name="id-1.2.10.3.8.7.5"></a><h4>Parameters</h4>
632
<div class="informaltable"><table width="100%" border="0">
634
<col width="150px" class="parameters_name">
635
<col class="parameters_description">
636
<col width="200px" class="parameters_annotations">
639
<td class="parameter_name"><p>conn</p></td>
640
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
641
<td class="parameter_annotations"> </td>
645
<div class="refsect3">
646
<a name="id-1.2.10.3.8.7.6"></a><h4>Returns</h4>
647
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</p>
652
<div class="refsect2">
653
<a name="gst-rtsp-connection-read"></a><h3>gst_rtsp_connection_read ()</h3>
654
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
655
gst_rtsp_connection_read (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
656
<em class="parameter"><code><span class="type">guint8</span> *data</code></em>,
657
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>,
658
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
659
<p>Attempt to read <em class="parameter"><code>size</code></em>
660
bytes into <em class="parameter"><code>data</code></em>
661
from the connected <em class="parameter"><code>conn</code></em>
663
the specified <em class="parameter"><code>timeout</code></em>
664
. <em class="parameter"><code>timeout</code></em>
665
can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function
666
might block forever.</p>
667
<p>This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.</p>
668
<div class="refsect3">
669
<a name="id-1.2.10.3.8.8.6"></a><h4>Parameters</h4>
670
<div class="informaltable"><table width="100%" border="0">
672
<col width="150px" class="parameters_name">
673
<col class="parameters_description">
674
<col width="200px" class="parameters_annotations">
678
<td class="parameter_name"><p>conn</p></td>
679
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
680
<td class="parameter_annotations"> </td>
683
<td class="parameter_name"><p>data</p></td>
684
<td class="parameter_description"><p>the data to read</p></td>
685
<td class="parameter_annotations"> </td>
688
<td class="parameter_name"><p>size</p></td>
689
<td class="parameter_description"><p>the size of <em class="parameter"><code>data</code></em>
691
<td class="parameter_annotations"> </td>
694
<td class="parameter_name"><p>timeout</p></td>
695
<td class="parameter_description"><p>a timeout value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a></p></td>
696
<td class="parameter_annotations"> </td>
701
<div class="refsect3">
702
<a name="id-1.2.10.3.8.8.7"></a><h4>Returns</h4>
703
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</p>
708
<div class="refsect2">
709
<a name="gst-rtsp-connection-write"></a><h3>gst_rtsp_connection_write ()</h3>
710
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
711
gst_rtsp_connection_write (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
712
<em class="parameter"><code>const <span class="type">guint8</span> *data</code></em>,
713
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>,
714
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
715
<p>Attempt to write <em class="parameter"><code>size</code></em>
716
bytes of <em class="parameter"><code>data</code></em>
717
to the connected <em class="parameter"><code>conn</code></em>
719
the specified <em class="parameter"><code>timeout</code></em>
720
. <em class="parameter"><code>timeout</code></em>
721
can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function
722
might block forever.</p>
723
<p>This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.</p>
724
<div class="refsect3">
725
<a name="id-1.2.10.3.8.9.6"></a><h4>Parameters</h4>
726
<div class="informaltable"><table width="100%" border="0">
728
<col width="150px" class="parameters_name">
729
<col class="parameters_description">
730
<col width="200px" class="parameters_annotations">
734
<td class="parameter_name"><p>conn</p></td>
735
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
736
<td class="parameter_annotations"> </td>
739
<td class="parameter_name"><p>data</p></td>
740
<td class="parameter_description"><p>the data to write</p></td>
741
<td class="parameter_annotations"> </td>
744
<td class="parameter_name"><p>size</p></td>
745
<td class="parameter_description"><p>the size of <em class="parameter"><code>data</code></em>
747
<td class="parameter_annotations"> </td>
750
<td class="parameter_name"><p>timeout</p></td>
751
<td class="parameter_description"><p>a timeout value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a></p></td>
752
<td class="parameter_annotations"> </td>
757
<div class="refsect3">
758
<a name="id-1.2.10.3.8.9.7"></a><h4>Returns</h4>
759
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</p>
764
<div class="refsect2">
765
<a name="gst-rtsp-connection-poll"></a><h3>gst_rtsp_connection_poll ()</h3>
766
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
767
gst_rtsp_connection_poll (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
768
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPEvent" title="enum GstRTSPEvent"><span class="type">GstRTSPEvent</span></a> events</code></em>,
769
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPEvent" title="enum GstRTSPEvent"><span class="type">GstRTSPEvent</span></a> *revents</code></em>,
770
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
771
<p>Wait up to the specified <em class="parameter"><code>timeout</code></em>
772
for the connection to become available for
773
at least one of the operations specified in <em class="parameter"><code>events</code></em>
774
. When the function returns
775
with <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>, <em class="parameter"><code>revents</code></em>
776
will contain a bitmask of available operations on
777
<em class="parameter"><code>conn</code></em>
779
<p><em class="parameter"><code>timeout</code></em>
780
can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function might block forever.</p>
781
<p>This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.</p>
782
<div class="refsect3">
783
<a name="id-1.2.10.3.8.10.7"></a><h4>Parameters</h4>
784
<div class="informaltable"><table width="100%" border="0">
786
<col width="150px" class="parameters_name">
787
<col class="parameters_description">
788
<col width="200px" class="parameters_annotations">
792
<td class="parameter_name"><p>conn</p></td>
793
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
794
<td class="parameter_annotations"> </td>
797
<td class="parameter_name"><p>events</p></td>
798
<td class="parameter_description"><p>a bitmask of <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPEvent" title="enum GstRTSPEvent"><span class="type">GstRTSPEvent</span></a> flags to check</p></td>
799
<td class="parameter_annotations"> </td>
802
<td class="parameter_name"><p>revents</p></td>
803
<td class="parameter_description"><p>location for result flags </p></td>
804
<td class="parameter_annotations"> </td>
807
<td class="parameter_name"><p>timeout</p></td>
808
<td class="parameter_description"><p>a timeout</p></td>
809
<td class="parameter_annotations"> </td>
814
<div class="refsect3">
815
<a name="id-1.2.10.3.8.10.8"></a><h4>Returns</h4>
816
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</p>
821
<div class="refsect2">
822
<a name="gst-rtsp-connection-send"></a><h3>gst_rtsp_connection_send ()</h3>
823
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
824
gst_rtsp_connection_send (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
825
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspmessage.html#GstRTSPMessage" title="struct GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>,
826
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
827
<p>Attempt to send <em class="parameter"><code>message</code></em>
828
to the connected <em class="parameter"><code>conn</code></em>
830
the specified <em class="parameter"><code>timeout</code></em>
831
. <em class="parameter"><code>timeout</code></em>
832
can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function
833
might block forever.</p>
834
<p>This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.</p>
835
<div class="refsect3">
836
<a name="id-1.2.10.3.8.11.6"></a><h4>Parameters</h4>
837
<div class="informaltable"><table width="100%" border="0">
839
<col width="150px" class="parameters_name">
840
<col class="parameters_description">
841
<col width="200px" class="parameters_annotations">
845
<td class="parameter_name"><p>conn</p></td>
846
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
847
<td class="parameter_annotations"> </td>
850
<td class="parameter_name"><p>message</p></td>
851
<td class="parameter_description"><p>the message to send</p></td>
852
<td class="parameter_annotations"> </td>
855
<td class="parameter_name"><p>timeout</p></td>
856
<td class="parameter_description"><p>a timeout value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a></p></td>
857
<td class="parameter_annotations"> </td>
862
<div class="refsect3">
863
<a name="id-1.2.10.3.8.11.7"></a><h4>Returns</h4>
864
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</p>
869
<div class="refsect2">
870
<a name="gst-rtsp-connection-receive"></a><h3>gst_rtsp_connection_receive ()</h3>
871
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
872
gst_rtsp_connection_receive (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
873
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspmessage.html#GstRTSPMessage" title="struct GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>,
874
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
875
<p>Attempt to read into <em class="parameter"><code>message</code></em>
876
from the connected <em class="parameter"><code>conn</code></em>
878
the specified <em class="parameter"><code>timeout</code></em>
879
. <em class="parameter"><code>timeout</code></em>
880
can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>, in which case this function
881
might block forever.</p>
882
<p>This function can be cancelled with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-flush" title="gst_rtsp_connection_flush ()"><code class="function">gst_rtsp_connection_flush()</code></a>.</p>
883
<div class="refsect3">
884
<a name="id-1.2.10.3.8.12.6"></a><h4>Parameters</h4>
885
<div class="informaltable"><table width="100%" border="0">
887
<col width="150px" class="parameters_name">
888
<col class="parameters_description">
889
<col width="200px" class="parameters_annotations">
893
<td class="parameter_name"><p>conn</p></td>
894
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
895
<td class="parameter_annotations"> </td>
898
<td class="parameter_name"><p>message</p></td>
899
<td class="parameter_description"><p>the message to read</p></td>
900
<td class="parameter_annotations"> </td>
903
<td class="parameter_name"><p>timeout</p></td>
904
<td class="parameter_description"><p>a timeout value or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a></p></td>
905
<td class="parameter_annotations"> </td>
910
<div class="refsect3">
911
<a name="id-1.2.10.3.8.12.7"></a><h4>Returns</h4>
912
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</p>
917
<div class="refsect2">
918
<a name="gst-rtsp-connection-next-timeout"></a><h3>gst_rtsp_connection_next_timeout ()</h3>
919
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
920
gst_rtsp_connection_next_timeout (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
921
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre>
922
<p>Calculate the next timeout for <em class="parameter"><code>conn</code></em>
923
, storing the result in <em class="parameter"><code>timeout</code></em>
925
<div class="refsect3">
926
<a name="id-1.2.10.3.8.13.5"></a><h4>Parameters</h4>
927
<div class="informaltable"><table width="100%" border="0">
929
<col width="150px" class="parameters_name">
930
<col class="parameters_description">
931
<col width="200px" class="parameters_annotations">
935
<td class="parameter_name"><p>conn</p></td>
936
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
937
<td class="parameter_annotations"> </td>
940
<td class="parameter_name"><p>timeout</p></td>
941
<td class="parameter_description"><p>a timeout</p></td>
942
<td class="parameter_annotations"> </td>
947
<div class="refsect3">
948
<a name="id-1.2.10.3.8.13.6"></a><h4>Returns</h4>
949
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p>
954
<div class="refsect2">
955
<a name="gst-rtsp-connection-reset-timeout"></a><h3>gst_rtsp_connection_reset_timeout ()</h3>
956
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
957
gst_rtsp_connection_reset_timeout (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
958
<p>Reset the timeout of <em class="parameter"><code>conn</code></em>
960
<div class="refsect3">
961
<a name="id-1.2.10.3.8.14.5"></a><h4>Parameters</h4>
962
<div class="informaltable"><table width="100%" border="0">
964
<col width="150px" class="parameters_name">
965
<col class="parameters_description">
966
<col width="200px" class="parameters_annotations">
969
<td class="parameter_name"><p>conn</p></td>
970
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
971
<td class="parameter_annotations"> </td>
975
<div class="refsect3">
976
<a name="id-1.2.10.3.8.14.6"></a><h4>Returns</h4>
977
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p>
982
<div class="refsect2">
983
<a name="gst-rtsp-connection-flush"></a><h3>gst_rtsp_connection_flush ()</h3>
984
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
985
gst_rtsp_connection_flush (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
986
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> flush</code></em>);</pre>
987
<p>Start or stop the flushing action on <em class="parameter"><code>conn</code></em>
988
. When flushing, all current
989
and future actions on <em class="parameter"><code>conn</code></em>
990
will return <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-EINTR:CAPS"><span class="type">GST_RTSP_EINTR</span></a> until the connection
991
is set to non-flushing mode again.</p>
992
<div class="refsect3">
993
<a name="id-1.2.10.3.8.15.5"></a><h4>Parameters</h4>
994
<div class="informaltable"><table width="100%" border="0">
996
<col width="150px" class="parameters_name">
997
<col class="parameters_description">
998
<col width="200px" class="parameters_annotations">
1002
<td class="parameter_name"><p>conn</p></td>
1003
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1004
<td class="parameter_annotations"> </td>
1007
<td class="parameter_name"><p>flush</p></td>
1008
<td class="parameter_description"><p>start or stop the flush</p></td>
1009
<td class="parameter_annotations"> </td>
1014
<div class="refsect3">
1015
<a name="id-1.2.10.3.8.15.6"></a><h4>Returns</h4>
1016
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p>
1021
<div class="refsect2">
1022
<a name="gst-rtsp-connection-set-auth"></a><h3>gst_rtsp_connection_set_auth ()</h3>
1023
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
1024
gst_rtsp_connection_set_auth (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1025
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPAuthMethod" title="enum GstRTSPAuthMethod"><span class="type">GstRTSPAuthMethod</span></a> method</code></em>,
1026
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *user</code></em>,
1027
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pass</code></em>);</pre>
1028
<p>Configure <em class="parameter"><code>conn</code></em>
1029
for authentication mode <em class="parameter"><code>method</code></em>
1030
with <em class="parameter"><code>user</code></em>
1031
and <em class="parameter"><code>pass</code></em>
1033
user and password respectively.</p>
1034
<div class="refsect3">
1035
<a name="id-1.2.10.3.8.16.5"></a><h4>Parameters</h4>
1036
<div class="informaltable"><table width="100%" border="0">
1038
<col width="150px" class="parameters_name">
1039
<col class="parameters_description">
1040
<col width="200px" class="parameters_annotations">
1044
<td class="parameter_name"><p>conn</p></td>
1045
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1046
<td class="parameter_annotations"> </td>
1049
<td class="parameter_name"><p>method</p></td>
1050
<td class="parameter_description"><p>authentication method</p></td>
1051
<td class="parameter_annotations"> </td>
1054
<td class="parameter_name"><p>user</p></td>
1055
<td class="parameter_description"><p>the user</p></td>
1056
<td class="parameter_annotations"> </td>
1059
<td class="parameter_name"><p>pass</p></td>
1060
<td class="parameter_description"><p>the password</p></td>
1061
<td class="parameter_annotations"> </td>
1066
<div class="refsect3">
1067
<a name="id-1.2.10.3.8.16.6"></a><h4>Returns</h4>
1068
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p>
1073
<div class="refsect2">
1074
<a name="gst-rtsp-connection-set-auth-param"></a><h3>gst_rtsp_connection_set_auth_param ()</h3>
1075
<pre class="programlisting"><span class="returnvalue">void</span>
1076
gst_rtsp_connection_set_auth_param (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1077
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *param</code></em>,
1078
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
1079
<p>Setup <em class="parameter"><code>conn</code></em>
1080
with authentication directives. This is not necesary for
746
1081
methods <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-AUTH-NONE:CAPS"><span class="type">GST_RTSP_AUTH_NONE</span></a> and <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-AUTH-BASIC:CAPS"><span class="type">GST_RTSP_AUTH_BASIC</span></a>. For
747
1082
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-AUTH-DIGEST:CAPS"><span class="type">GST_RTSP_AUTH_DIGEST</span></a>, directives should be taken from the digest challenge
748
1083
in the WWW-Authenticate response header and can include realm, domain,
749
nonce, opaque, stale, algorithm, qop as per RFC2617.
751
<div class="variablelist"><table border="0" class="variablelist">
753
<col align="left" valign="top">
758
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
759
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
763
<td><p><span class="term"><em class="parameter"><code>param</code></em> :</span></p></td>
764
<td>authentication directive</td>
767
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
774
<div class="refsect2">
775
<a name="gst-rtsp-connection-clear-auth-params"></a><h3>gst_rtsp_connection_clear_auth_params ()</h3>
776
<pre class="programlisting"><span class="returnvalue">void</span> gst_rtsp_connection_clear_auth_params
777
(<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
779
Clear the list of authentication directives stored in <em class="parameter"><code>conn</code></em>.
781
<div class="variablelist"><table border="0" class="variablelist">
783
<col align="left" valign="top">
787
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
788
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
794
<div class="refsect2">
795
<a name="gst-rtsp-connection-set-qos-dscp"></a><h3>gst_rtsp_connection_set_qos_dscp ()</h3>
796
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_set_qos_dscp (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
797
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> qos_dscp</code></em>);</pre>
799
Configure <em class="parameter"><code>conn</code></em> to use the specified DSCP value.
801
<div class="variablelist"><table border="0" class="variablelist">
803
<col align="left" valign="top">
808
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
809
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
813
<td><p><span class="term"><em class="parameter"><code>qos_dscp</code></em> :</span></p></td>
817
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
819
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</td>
825
<div class="refsect2">
826
<a name="gst-rtsp-connection-set-ip"></a><h3>gst_rtsp_connection_set_ip ()</h3>
827
<pre class="programlisting"><span class="returnvalue">void</span> gst_rtsp_connection_set_ip (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
828
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ip</code></em>);</pre>
830
Set the IP address of the server.
832
<div class="variablelist"><table border="0" class="variablelist">
834
<col align="left" valign="top">
839
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
840
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
844
<td><p><span class="term"><em class="parameter"><code>ip</code></em> :</span></p></td>
845
<td>an ip address</td>
851
<div class="refsect2">
852
<a name="gst-rtsp-connection-get-ip"></a><h3>gst_rtsp_connection_get_ip ()</h3>
853
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gst_rtsp_connection_get_ip (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
855
Retrieve the IP address of the other end of <em class="parameter"><code>conn</code></em>.
857
<div class="variablelist"><table border="0" class="variablelist">
859
<col align="left" valign="top">
864
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
865
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
869
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
870
<td>The IP address as a string. this value remains valid until the
871
connection is closed.</td>
877
<div class="refsect2">
878
<a name="gst-rtsp-connection-get-url"></a><h3>gst_rtsp_connection_get_url ()</h3>
879
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> * gst_rtsp_connection_get_url (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
881
Retrieve the URL of the other end of <em class="parameter"><code>conn</code></em>.
883
<div class="variablelist"><table border="0" class="variablelist">
885
<col align="left" valign="top">
890
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
891
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
895
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
896
<td>The URL. This value remains valid until the
897
connection is freed.</td>
903
<div class="refsect2">
904
<a name="gst-rtsp-connection-set-tunneled"></a><h3>gst_rtsp_connection_set_tunneled ()</h3>
905
<pre class="programlisting"><span class="returnvalue">void</span> gst_rtsp_connection_set_tunneled (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
906
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> tunneled</code></em>);</pre>
908
Set the HTTP tunneling state of the connection. This must be configured before
909
the <em class="parameter"><code>conn</code></em> is connected.
911
<div class="variablelist"><table border="0" class="variablelist">
913
<col align="left" valign="top">
918
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
919
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
923
<td><p><span class="term"><em class="parameter"><code>tunneled</code></em> :</span></p></td>
924
<td>the new state</td>
930
<div class="refsect2">
931
<a name="gst-rtsp-connection-is-tunneled"></a><h3>gst_rtsp_connection_is_tunneled ()</h3>
932
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gst_rtsp_connection_is_tunneled (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
934
Get the tunneling state of the connection.
936
<div class="variablelist"><table border="0" class="variablelist">
938
<col align="left" valign="top">
943
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
944
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
948
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
949
<td>if <em class="parameter"><code>conn</code></em> is using HTTP tunneling.</td>
955
<div class="refsect2">
956
<a name="gst-rtsp-connection-get-tunnelid"></a><h3>gst_rtsp_connection_get_tunnelid ()</h3>
957
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gst_rtsp_connection_get_tunnelid (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
959
Get the tunnel session id the connection.
961
<div class="variablelist"><table border="0" class="variablelist">
963
<col align="left" valign="top">
968
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
969
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
973
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
974
<td>returns a non-empty string if <em class="parameter"><code>conn</code></em> is being tunneled over HTTP.</td>
980
<div class="refsect2">
981
<a name="gst-rtsp-connection-do-tunnel"></a><h3>gst_rtsp_connection_do_tunnel ()</h3>
982
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_do_tunnel (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
983
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn2</code></em>);</pre>
985
If <em class="parameter"><code>conn</code></em> received the first tunnel connection and <em class="parameter"><code>conn2</code></em> received
1084
nonce, opaque, stale, algorithm, qop as per RFC2617.</p>
1085
<div class="refsect3">
1086
<a name="id-1.2.10.3.8.17.5"></a><h4>Parameters</h4>
1087
<div class="informaltable"><table width="100%" border="0">
1089
<col width="150px" class="parameters_name">
1090
<col class="parameters_description">
1091
<col width="200px" class="parameters_annotations">
1095
<td class="parameter_name"><p>conn</p></td>
1096
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1097
<td class="parameter_annotations"> </td>
1100
<td class="parameter_name"><p>param</p></td>
1101
<td class="parameter_description"><p>authentication directive</p></td>
1102
<td class="parameter_annotations"> </td>
1105
<td class="parameter_name"><p>value</p></td>
1106
<td class="parameter_description"><p>value</p></td>
1107
<td class="parameter_annotations"> </td>
1114
<div class="refsect2">
1115
<a name="gst-rtsp-connection-clear-auth-params"></a><h3>gst_rtsp_connection_clear_auth_params ()</h3>
1116
<pre class="programlisting"><span class="returnvalue">void</span>
1117
gst_rtsp_connection_clear_auth_params (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1118
<p>Clear the list of authentication directives stored in <em class="parameter"><code>conn</code></em>
1120
<div class="refsect3">
1121
<a name="id-1.2.10.3.8.18.5"></a><h4>Parameters</h4>
1122
<div class="informaltable"><table width="100%" border="0">
1124
<col width="150px" class="parameters_name">
1125
<col class="parameters_description">
1126
<col width="200px" class="parameters_annotations">
1129
<td class="parameter_name"><p>conn</p></td>
1130
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1131
<td class="parameter_annotations"> </td>
1137
<div class="refsect2">
1138
<a name="gst-rtsp-connection-set-qos-dscp"></a><h3>gst_rtsp_connection_set_qos_dscp ()</h3>
1139
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
1140
gst_rtsp_connection_set_qos_dscp (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1141
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> qos_dscp</code></em>);</pre>
1142
<p>Configure <em class="parameter"><code>conn</code></em>
1143
to use the specified DSCP value.</p>
1144
<div class="refsect3">
1145
<a name="id-1.2.10.3.8.19.5"></a><h4>Parameters</h4>
1146
<div class="informaltable"><table width="100%" border="0">
1148
<col width="150px" class="parameters_name">
1149
<col class="parameters_description">
1150
<col width="200px" class="parameters_annotations">
1154
<td class="parameter_name"><p>conn</p></td>
1155
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1156
<td class="parameter_annotations"> </td>
1159
<td class="parameter_name"><p>qos_dscp</p></td>
1160
<td class="parameter_description"><p>DSCP value</p></td>
1161
<td class="parameter_annotations"> </td>
1166
<div class="refsect3">
1167
<a name="id-1.2.10.3.8.19.6"></a><h4>Returns</h4>
1168
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</p>
1173
<div class="refsect2">
1174
<a name="gst-rtsp-connection-set-ip"></a><h3>gst_rtsp_connection_set_ip ()</h3>
1175
<pre class="programlisting"><span class="returnvalue">void</span>
1176
gst_rtsp_connection_set_ip (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1177
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ip</code></em>);</pre>
1178
<p>Set the IP address of the server.</p>
1179
<div class="refsect3">
1180
<a name="id-1.2.10.3.8.20.5"></a><h4>Parameters</h4>
1181
<div class="informaltable"><table width="100%" border="0">
1183
<col width="150px" class="parameters_name">
1184
<col class="parameters_description">
1185
<col width="200px" class="parameters_annotations">
1189
<td class="parameter_name"><p>conn</p></td>
1190
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1191
<td class="parameter_annotations"> </td>
1194
<td class="parameter_name"><p>ip</p></td>
1195
<td class="parameter_description"><p>an ip address</p></td>
1196
<td class="parameter_annotations"> </td>
1203
<div class="refsect2">
1204
<a name="gst-rtsp-connection-get-ip"></a><h3>gst_rtsp_connection_get_ip ()</h3>
1205
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1206
gst_rtsp_connection_get_ip (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1207
<p>Retrieve the IP address of the other end of <em class="parameter"><code>conn</code></em>
1209
<div class="refsect3">
1210
<a name="id-1.2.10.3.8.21.5"></a><h4>Parameters</h4>
1211
<div class="informaltable"><table width="100%" border="0">
1213
<col width="150px" class="parameters_name">
1214
<col class="parameters_description">
1215
<col width="200px" class="parameters_annotations">
1218
<td class="parameter_name"><p>conn</p></td>
1219
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1220
<td class="parameter_annotations"> </td>
1224
<div class="refsect3">
1225
<a name="id-1.2.10.3.8.21.6"></a><h4>Returns</h4>
1226
<p> The IP address as a string. this value remains valid until the
1227
connection is closed.</p>
1232
<div class="refsect2">
1233
<a name="gst-rtsp-connection-get-url"></a><h3>gst_rtsp_connection_get_url ()</h3>
1234
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspurl.html#GstRTSPUrl" title="struct GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> *
1235
gst_rtsp_connection_get_url (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1236
<p>Retrieve the URL of the other end of <em class="parameter"><code>conn</code></em>
1238
<div class="refsect3">
1239
<a name="id-1.2.10.3.8.22.5"></a><h4>Parameters</h4>
1240
<div class="informaltable"><table width="100%" border="0">
1242
<col width="150px" class="parameters_name">
1243
<col class="parameters_description">
1244
<col width="200px" class="parameters_annotations">
1247
<td class="parameter_name"><p>conn</p></td>
1248
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1249
<td class="parameter_annotations"> </td>
1253
<div class="refsect3">
1254
<a name="id-1.2.10.3.8.22.6"></a><h4>Returns</h4>
1255
<p> The URL. This value remains valid until the
1256
connection is freed.</p>
1261
<div class="refsect2">
1262
<a name="gst-rtsp-connection-set-tunneled"></a><h3>gst_rtsp_connection_set_tunneled ()</h3>
1263
<pre class="programlisting"><span class="returnvalue">void</span>
1264
gst_rtsp_connection_set_tunneled (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1265
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> tunneled</code></em>);</pre>
1266
<p>Set the HTTP tunneling state of the connection. This must be configured before
1267
the <em class="parameter"><code>conn</code></em>
1269
<div class="refsect3">
1270
<a name="id-1.2.10.3.8.23.5"></a><h4>Parameters</h4>
1271
<div class="informaltable"><table width="100%" border="0">
1273
<col width="150px" class="parameters_name">
1274
<col class="parameters_description">
1275
<col width="200px" class="parameters_annotations">
1279
<td class="parameter_name"><p>conn</p></td>
1280
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1281
<td class="parameter_annotations"> </td>
1284
<td class="parameter_name"><p>tunneled</p></td>
1285
<td class="parameter_description"><p>the new state</p></td>
1286
<td class="parameter_annotations"> </td>
1293
<div class="refsect2">
1294
<a name="gst-rtsp-connection-is-tunneled"></a><h3>gst_rtsp_connection_is_tunneled ()</h3>
1295
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1296
gst_rtsp_connection_is_tunneled (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1297
<p>Get the tunneling state of the connection.</p>
1298
<div class="refsect3">
1299
<a name="id-1.2.10.3.8.24.5"></a><h4>Parameters</h4>
1300
<div class="informaltable"><table width="100%" border="0">
1302
<col width="150px" class="parameters_name">
1303
<col class="parameters_description">
1304
<col width="200px" class="parameters_annotations">
1307
<td class="parameter_name"><p>conn</p></td>
1308
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1309
<td class="parameter_annotations"> </td>
1313
<div class="refsect3">
1314
<a name="id-1.2.10.3.8.24.6"></a><h4>Returns</h4>
1315
<p> if <em class="parameter"><code>conn</code></em>
1316
is using HTTP tunneling.</p>
1321
<div class="refsect2">
1322
<a name="gst-rtsp-connection-get-tunnelid"></a><h3>gst_rtsp_connection_get_tunnelid ()</h3>
1323
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1324
gst_rtsp_connection_get_tunnelid (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1325
<p>Get the tunnel session id the connection.</p>
1326
<div class="refsect3">
1327
<a name="id-1.2.10.3.8.25.5"></a><h4>Parameters</h4>
1328
<div class="informaltable"><table width="100%" border="0">
1330
<col width="150px" class="parameters_name">
1331
<col class="parameters_description">
1332
<col width="200px" class="parameters_annotations">
1335
<td class="parameter_name"><p>conn</p></td>
1336
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1337
<td class="parameter_annotations"> </td>
1341
<div class="refsect3">
1342
<a name="id-1.2.10.3.8.25.6"></a><h4>Returns</h4>
1343
<p> returns a non-empty string if <em class="parameter"><code>conn</code></em>
1344
is being tunneled over HTTP.</p>
1349
<div class="refsect2">
1350
<a name="gst-rtsp-connection-do-tunnel"></a><h3>gst_rtsp_connection_do_tunnel ()</h3>
1351
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
1352
gst_rtsp_connection_do_tunnel (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1353
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn2</code></em>);</pre>
1354
<p>If <em class="parameter"><code>conn</code></em>
1355
received the first tunnel connection and <em class="parameter"><code>conn2</code></em>
986
1357
the second tunnel connection, link the two connections together so that
987
<em class="parameter"><code>conn</code></em> manages the tunneled connection.
990
After this call, <em class="parameter"><code>conn2</code></em> cannot be used anymore and must be freed with
991
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-free" title="gst_rtsp_connection_free ()"><code class="function">gst_rtsp_connection_free()</code></a>.
994
If <em class="parameter"><code>conn2</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then only the base64 decoding context will be setup for
995
<em class="parameter"><code>conn</code></em>.
997
<div class="variablelist"><table border="0" class="variablelist">
1358
<em class="parameter"><code>conn</code></em>
1359
manages the tunneled connection.</p>
1360
<p>After this call, <em class="parameter"><code>conn2</code></em>
1361
cannot be used anymore and must be freed with
1362
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-free" title="gst_rtsp_connection_free ()"><code class="function">gst_rtsp_connection_free()</code></a>.</p>
1363
<p>If <em class="parameter"><code>conn2</code></em>
1364
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then only the base64 decoding context will be setup for
1365
<em class="parameter"><code>conn</code></em>
1367
<div class="refsect3">
1368
<a name="id-1.2.10.3.8.26.7"></a><h4>Parameters</h4>
1369
<div class="informaltable"><table width="100%" border="0">
999
<col align="left" valign="top">
1371
<col width="150px" class="parameters_name">
1372
<col class="parameters_description">
1373
<col width="200px" class="parameters_annotations">
1004
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
1005
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
1009
<td><p><span class="term"><em class="parameter"><code>conn2</code></em> :</span></p></td>
1010
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1014
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1015
<td>return GST_RTSP_OK on success.</td>
1377
<td class="parameter_name"><p>conn</p></td>
1378
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1379
<td class="parameter_annotations"> </td>
1382
<td class="parameter_name"><p>conn2</p></td>
1383
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1384
<td class="parameter_annotations"> </td>
1389
<div class="refsect3">
1390
<a name="id-1.2.10.3.8.26.8"></a><h4>Returns</h4>
1391
<p> return GST_RTSP_OK on success.</p>
1021
1396
<div class="refsect2">
1022
<a name="gst-rtsp-connection-set-http-mode"></a><h3>gst_rtsp_connection_set_http_mode ()</h3>
1023
<pre class="programlisting"><span class="returnvalue">void</span> gst_rtsp_connection_set_http_mode (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1024
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable</code></em>);</pre>
1026
By setting the HTTP mode to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> the message parsing will support HTTP
1397
<a name="gst-rtsp-connection-set-http-mode"></a><h3>gst_rtsp_connection_set_http_mode ()</h3>
1398
<pre class="programlisting"><span class="returnvalue">void</span>
1399
gst_rtsp_connection_set_http_mode (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1400
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable</code></em>);</pre>
1401
<p>By setting the HTTP mode to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> the message parsing will support HTTP
1027
1402
messages in addition to the RTSP messages. It will also disable the
1028
automatic handling of setting up an HTTP tunnel.
1030
<div class="variablelist"><table border="0" class="variablelist">
1032
<col align="left" valign="top">
1037
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
1038
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
1042
<td><p><span class="term"><em class="parameter"><code>enable</code></em> :</span></p></td>
1044
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to enable manual HTTP mode</td>
1050
<div class="refsect2">
1051
<a name="gst-rtsp-connection-set-proxy"></a><h3>gst_rtsp_connection_set_proxy ()</h3>
1052
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> gst_rtsp_connection_set_proxy (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1053
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host</code></em>,
1054
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> port</code></em>);</pre>
1056
Set the proxy host and port.
1058
<div class="variablelist"><table border="0" class="variablelist">
1060
<col align="left" valign="top">
1065
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
1066
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
1070
<td><p><span class="term"><em class="parameter"><code>host</code></em> :</span></p></td>
1071
<td>the proxy host</td>
1074
<td><p><span class="term"><em class="parameter"><code>port</code></em> :</span></p></td>
1075
<td>the proxy port</td>
1078
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1080
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</td>
1086
<div class="refsect2">
1087
<a name="gst-rtsp-connection-get-read-socket"></a><h3>gst_rtsp_connection_get_read_socket ()</h3>
1088
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="returnvalue">GSocket</span></a> * gst_rtsp_connection_get_read_socket (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1091
<div class="refsect2">
1092
<a name="gst-rtsp-connection-get-write-socket"></a><h3>gst_rtsp_connection_get_write_socket ()</h3>
1093
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="returnvalue">GSocket</span></a> * gst_rtsp_connection_get_write_socket
1094
(<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1096
Get the file descriptor for writing.
1098
<div class="variablelist"><table border="0" class="variablelist">
1100
<col align="left" valign="top">
1105
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
1106
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
1110
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1111
<td>the file descriptor used for writing or NULL on error. The file
1112
descriptor remains valid until the connection is closed.</td>
1118
<div class="refsect2">
1119
<a name="gst-rtsp-connection-get-tls"></a><h3>gst_rtsp_connection_get_tls ()</h3>
1120
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GTlsConnection.html"><span class="returnvalue">GTlsConnection</span></a> * gst_rtsp_connection_get_tls (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1121
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1123
Get the TLS connection of <em class="parameter"><code>conn</code></em>.
1126
For client side this will return the <a href="http://library.gnome.org/devel/gio/unstable/GTlsClientConnection.html"><span class="type">GTlsClientConnection</span></a> when connected
1130
For server side connections, this function will create a GTlsServerConnection
1403
automatic handling of setting up an HTTP tunnel.</p>
1404
<div class="refsect3">
1405
<a name="id-1.2.10.3.8.27.5"></a><h4>Parameters</h4>
1406
<div class="informaltable"><table width="100%" border="0">
1408
<col width="150px" class="parameters_name">
1409
<col class="parameters_description">
1410
<col width="200px" class="parameters_annotations">
1414
<td class="parameter_name"><p>conn</p></td>
1415
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1416
<td class="parameter_annotations"> </td>
1419
<td class="parameter_name"><p>enable</p></td>
1420
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to enable manual HTTP mode</p></td>
1421
<td class="parameter_annotations"> </td>
1428
<div class="refsect2">
1429
<a name="gst-rtsp-connection-set-proxy"></a><h3>gst_rtsp_connection_set_proxy ()</h3>
1430
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
1431
gst_rtsp_connection_set_proxy (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1432
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host</code></em>,
1433
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> port</code></em>);</pre>
1434
<p>Set the proxy host and port.</p>
1435
<div class="refsect3">
1436
<a name="id-1.2.10.3.8.28.5"></a><h4>Parameters</h4>
1437
<div class="informaltable"><table width="100%" border="0">
1439
<col width="150px" class="parameters_name">
1440
<col class="parameters_description">
1441
<col width="200px" class="parameters_annotations">
1445
<td class="parameter_name"><p>conn</p></td>
1446
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1447
<td class="parameter_annotations"> </td>
1450
<td class="parameter_name"><p>host</p></td>
1451
<td class="parameter_description"><p>the proxy host</p></td>
1452
<td class="parameter_annotations"> </td>
1455
<td class="parameter_name"><p>port</p></td>
1456
<td class="parameter_description"><p>the proxy port</p></td>
1457
<td class="parameter_annotations"> </td>
1462
<div class="refsect3">
1463
<a name="id-1.2.10.3.8.28.6"></a><h4>Returns</h4>
1464
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p>
1469
<div class="refsect2">
1470
<a name="gst-rtsp-connection-get-read-socket"></a><h3>gst_rtsp_connection_get_read_socket ()</h3>
1471
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="returnvalue">GSocket</span></a> *
1472
gst_rtsp_connection_get_read_socket (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1475
<div class="refsect2">
1476
<a name="gst-rtsp-connection-get-write-socket"></a><h3>gst_rtsp_connection_get_write_socket ()</h3>
1477
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GSocket.html"><span class="returnvalue">GSocket</span></a> *
1478
gst_rtsp_connection_get_write_socket (<em class="parameter"><code>const <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1479
<p>Get the file descriptor for writing.</p>
1480
<div class="refsect3">
1481
<a name="id-1.2.10.3.8.30.5"></a><h4>Parameters</h4>
1482
<div class="informaltable"><table width="100%" border="0">
1484
<col width="150px" class="parameters_name">
1485
<col class="parameters_description">
1486
<col width="200px" class="parameters_annotations">
1489
<td class="parameter_name"><p>conn</p></td>
1490
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1491
<td class="parameter_annotations"> </td>
1495
<div class="refsect3">
1496
<a name="id-1.2.10.3.8.30.6"></a><h4>Returns</h4>
1497
<p> the file descriptor used for writing or NULL on error. The file
1498
descriptor remains valid until the connection is closed.</p>
1503
<div class="refsect2">
1504
<a name="gst-rtsp-connection-get-tls"></a><h3>gst_rtsp_connection_get_tls ()</h3>
1505
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GTlsConnection.html"><span class="returnvalue">GTlsConnection</span></a> *
1506
gst_rtsp_connection_get_tls (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1507
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1508
<p>Get the TLS connection of <em class="parameter"><code>conn</code></em>
1510
<p>For client side this will return the <a href="http://library.gnome.org/devel/gio/unstable/GTlsClientConnection.html"><span class="type">GTlsClientConnection</span></a> when connected
1512
<p>For server side connections, this function will create a GTlsServerConnection
1131
1513
when called the first time and will return that same connection on subsequent
1132
calls. The server is then responsible for configuring the TLS connection.
1134
<div class="variablelist"><table border="0" class="variablelist">
1514
calls. The server is then responsible for configuring the TLS connection.</p>
1515
<div class="refsect3">
1516
<a name="id-1.2.10.3.8.31.7"></a><h4>Parameters</h4>
1517
<div class="informaltable"><table width="100%" border="0">
1136
<col align="left" valign="top">
1519
<col width="150px" class="parameters_name">
1520
<col class="parameters_description">
1521
<col width="200px" class="parameters_annotations">
1141
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
1142
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
1146
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1148
<a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or NULL to ignore.</td>
1151
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1152
<td>the TLS connection for <em class="parameter"><code>conn</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1525
<td class="parameter_name"><p>conn</p></td>
1526
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1527
<td class="parameter_annotations"> </td>
1530
<td class="parameter_name"><p>error</p></td>
1531
<td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or NULL to ignore.</p></td>
1532
<td class="parameter_annotations"> </td>
1537
<div class="refsect3">
1538
<a name="id-1.2.10.3.8.31.8"></a><h4>Returns</h4>
1539
<p> the TLS connection for <em class="parameter"><code>conn</code></em>
1541
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
1157
1543
<p class="since">Since 1.2</p>
1160
1546
<div class="refsect2">
1161
<a name="gst-rtsp-connection-set-tls-validation-flags"></a><h3>gst_rtsp_connection_set_tls_validation_flags ()</h3>
1162
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gst_rtsp_connection_set_tls_validation_flags
1163
(<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1164
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> flags</code></em>);</pre>
1166
Sets the TLS validation flags to be used to verify the peer
1167
certificate when a TLS connection is established.
1169
<div class="variablelist"><table border="0" class="variablelist">
1171
<col align="left" valign="top">
1176
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
1177
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
1181
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
1182
<td>the validation flags.</td>
1185
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1186
<td>TRUE if the validation flags are set correctly, or FALSE if
1187
<em class="parameter"><code>conn</code></em> is NULL or is not a TLS connection.</td>
1191
<p class="since">Since 1.2.1</p>
1194
<div class="refsect2">
1195
<a name="gst-rtsp-connection-get-tls-validation-flags"></a><h3>gst_rtsp_connection_get_tls_validation_flags ()</h3>
1196
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a> gst_rtsp_connection_get_tls_validation_flags
1197
(<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1199
Gets the TLS validation flags used to verify the peer certificate
1200
when a TLS connection is established.
1202
<div class="variablelist"><table border="0" class="variablelist">
1204
<col align="left" valign="top">
1209
<td><p><span class="term"><em class="parameter"><code>conn</code></em> :</span></p></td>
1210
<td>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a>
1214
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1215
<td>the validationg flags.</td>
1219
<p class="since">Since 1.2.1</p>
1547
<a name="gst-rtsp-connection-set-tls-validation-flags"></a><h3>gst_rtsp_connection_set_tls_validation_flags ()</h3>
1548
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1549
gst_rtsp_connection_set_tls_validation_flags
1550
(<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1551
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> flags</code></em>);</pre>
1552
<p>Sets the TLS validation flags to be used to verify the peer
1553
certificate when a TLS connection is established.</p>
1554
<div class="refsect3">
1555
<a name="id-1.2.10.3.8.32.5"></a><h4>Parameters</h4>
1556
<div class="informaltable"><table width="100%" border="0">
1558
<col width="150px" class="parameters_name">
1559
<col class="parameters_description">
1560
<col width="200px" class="parameters_annotations">
1564
<td class="parameter_name"><p>conn</p></td>
1565
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1566
<td class="parameter_annotations"> </td>
1569
<td class="parameter_name"><p>flags</p></td>
1570
<td class="parameter_description"><p>the validation flags.</p></td>
1571
<td class="parameter_annotations"> </td>
1576
<div class="refsect3">
1577
<a name="id-1.2.10.3.8.32.6"></a><h4>Returns</h4>
1578
<p> TRUE if the validation flags are set correctly, or FALSE if
1579
<em class="parameter"><code>conn</code></em>
1580
is NULL or is not a TLS connection.</p>
1583
<p class="since">Since 1.2.1</p>
1586
<div class="refsect2">
1587
<a name="gst-rtsp-connection-get-tls-validation-flags"></a><h3>gst_rtsp_connection_get_tls_validation_flags ()</h3>
1588
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a>
1589
gst_rtsp_connection_get_tls_validation_flags
1590
(<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>);</pre>
1591
<p>Gets the TLS validation flags used to verify the peer certificate
1592
when a TLS connection is established.</p>
1593
<div class="refsect3">
1594
<a name="id-1.2.10.3.8.33.5"></a><h4>Parameters</h4>
1595
<div class="informaltable"><table width="100%" border="0">
1597
<col width="150px" class="parameters_name">
1598
<col class="parameters_description">
1599
<col width="200px" class="parameters_annotations">
1602
<td class="parameter_name"><p>conn</p></td>
1603
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1604
<td class="parameter_annotations"> </td>
1608
<div class="refsect3">
1609
<a name="id-1.2.10.3.8.33.6"></a><h4>Returns</h4>
1610
<p> the validationg flags.</p>
1613
<p class="since">Since 1.2.1</p>
1616
<div class="refsect2">
1617
<a name="gst-rtsp-watch-new"></a><h3>gst_rtsp_watch_new ()</h3>
1618
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="returnvalue">GstRTSPWatch</span></a> *
1619
gst_rtsp_watch_new (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> *conn</code></em>,
1620
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatchFuncs" title="GstRTSPWatchFuncs"><span class="type">GstRTSPWatchFuncs</span></a> *funcs</code></em>,
1621
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
1622
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);</pre>
1623
<p>Create a watch object for <em class="parameter"><code>conn</code></em>
1624
. The functions provided in <em class="parameter"><code>funcs</code></em>
1626
called with <em class="parameter"><code>user_data</code></em>
1627
when activity happened on the watch.</p>
1628
<p>The new watch is usually created so that it can be attached to a
1629
maincontext with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-attach" title="gst_rtsp_watch_attach ()"><code class="function">gst_rtsp_watch_attach()</code></a>. </p>
1630
<p><em class="parameter"><code>conn</code></em>
1631
must exist for the entire lifetime of the watch.</p>
1632
<div class="refsect3">
1633
<a name="id-1.2.10.3.8.34.7"></a><h4>Parameters</h4>
1634
<div class="informaltable"><table width="100%" border="0">
1636
<col width="150px" class="parameters_name">
1637
<col class="parameters_description">
1638
<col width="200px" class="parameters_annotations">
1642
<td class="parameter_name"><p>conn</p></td>
1643
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a></p></td>
1644
<td class="parameter_annotations"> </td>
1647
<td class="parameter_name"><p>funcs</p></td>
1648
<td class="parameter_description"><p>watch functions</p></td>
1649
<td class="parameter_annotations"> </td>
1652
<td class="parameter_name"><p>user_data</p></td>
1653
<td class="parameter_description"><p>user data to pass to <em class="parameter"><code>funcs</code></em>
1655
<td class="parameter_annotations"> </td>
1658
<td class="parameter_name"><p>notify</p></td>
1659
<td class="parameter_description"><p>notify when <em class="parameter"><code>user_data</code></em>
1660
is not referenced anymore</p></td>
1661
<td class="parameter_annotations"> </td>
1666
<div class="refsect3">
1667
<a name="id-1.2.10.3.8.34.8"></a><h4>Returns</h4>
1668
<p> a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> that can be used for asynchronous RTSP
1669
communication. Free with <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-unref" title="gst_rtsp_watch_unref ()"><code class="function">gst_rtsp_watch_unref()</code></a> after usage.</p>
1674
<div class="refsect2">
1675
<a name="gst-rtsp-watch-unref"></a><h3>gst_rtsp_watch_unref ()</h3>
1676
<pre class="programlisting"><span class="returnvalue">void</span>
1677
gst_rtsp_watch_unref (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>);</pre>
1678
<p>Decreases the reference count of <em class="parameter"><code>watch</code></em>
1679
by one. If the resulting reference
1680
count is zero the watch and associated memory will be destroyed.</p>
1681
<div class="refsect3">
1682
<a name="id-1.2.10.3.8.35.5"></a><h4>Parameters</h4>
1683
<div class="informaltable"><table width="100%" border="0">
1685
<col width="150px" class="parameters_name">
1686
<col class="parameters_description">
1687
<col width="200px" class="parameters_annotations">
1690
<td class="parameter_name"><p>watch</p></td>
1691
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a></p></td>
1692
<td class="parameter_annotations"> </td>
1698
<div class="refsect2">
1699
<a name="gst-rtsp-watch-attach"></a><h3>gst_rtsp_watch_attach ()</h3>
1700
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
1701
gst_rtsp_watch_attach (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
1702
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>);</pre>
1703
<p>Adds a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> to a context so that it will be executed within that context.</p>
1704
<div class="refsect3">
1705
<a name="id-1.2.10.3.8.36.5"></a><h4>Parameters</h4>
1706
<div class="informaltable"><table width="100%" border="0">
1708
<col width="150px" class="parameters_name">
1709
<col class="parameters_description">
1710
<col width="200px" class="parameters_annotations">
1714
<td class="parameter_name"><p>watch</p></td>
1715
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a></p></td>
1716
<td class="parameter_annotations"> </td>
1719
<td class="parameter_name"><p>context</p></td>
1720
<td class="parameter_description"><p>a GMainContext (if NULL, the default context will be used)</p></td>
1721
<td class="parameter_annotations"> </td>
1726
<div class="refsect3">
1727
<a name="id-1.2.10.3.8.36.6"></a><h4>Returns</h4>
1728
<p> the ID (greater than 0) for the watch within the GMainContext. </p>
1733
<div class="refsect2">
1734
<a name="gst-rtsp-watch-reset"></a><h3>gst_rtsp_watch_reset ()</h3>
1735
<pre class="programlisting"><span class="returnvalue">void</span>
1736
gst_rtsp_watch_reset (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>);</pre>
1737
<p>Reset <em class="parameter"><code>watch</code></em>
1738
, this is usually called after <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-connection-do-tunnel" title="gst_rtsp_connection_do_tunnel ()"><code class="function">gst_rtsp_connection_do_tunnel()</code></a>
1739
when the file descriptors of the connection might have changed.</p>
1740
<div class="refsect3">
1741
<a name="id-1.2.10.3.8.37.5"></a><h4>Parameters</h4>
1742
<div class="informaltable"><table width="100%" border="0">
1744
<col width="150px" class="parameters_name">
1745
<col class="parameters_description">
1746
<col width="200px" class="parameters_annotations">
1749
<td class="parameter_name"><p>watch</p></td>
1750
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a></p></td>
1751
<td class="parameter_annotations"> </td>
1757
<div class="refsect2">
1758
<a name="gst-rtsp-watch-send-message"></a><h3>gst_rtsp_watch_send_message ()</h3>
1759
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
1760
gst_rtsp_watch_send_message (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
1761
<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspmessage.html#GstRTSPMessage" title="struct GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>,
1762
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *id</code></em>);</pre>
1763
<p>Send a <em class="parameter"><code>message</code></em>
1764
using the connection of the <em class="parameter"><code>watch</code></em>
1765
. If it cannot be sent
1766
immediately, it will be queued for transmission in <em class="parameter"><code>watch</code></em>
1768
<em class="parameter"><code>message</code></em>
1769
will then be serialized and transmitted when the connection of the
1770
<em class="parameter"><code>watch</code></em>
1771
becomes writable. In case the <em class="parameter"><code>message</code></em>
1772
is queued, the ID returned in
1773
<em class="parameter"><code>id</code></em>
1774
will be non-zero and used as the ID argument in the message_sent
1776
<div class="refsect3">
1777
<a name="id-1.2.10.3.8.38.5"></a><h4>Parameters</h4>
1778
<div class="informaltable"><table width="100%" border="0">
1780
<col width="150px" class="parameters_name">
1781
<col class="parameters_description">
1782
<col width="200px" class="parameters_annotations">
1786
<td class="parameter_name"><p>watch</p></td>
1787
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a></p></td>
1788
<td class="parameter_annotations"> </td>
1791
<td class="parameter_name"><p>message</p></td>
1792
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspmessage.html#GstRTSPMessage" title="struct GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td>
1793
<td class="parameter_annotations"> </td>
1796
<td class="parameter_name"><p>id</p></td>
1797
<td class="parameter_description"><p> location for a message ID or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1798
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1803
<div class="refsect3">
1804
<a name="id-1.2.10.3.8.38.6"></a><h4>Returns</h4>
1805
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success.</p>
1810
<div class="refsect2">
1811
<a name="gst-rtsp-watch-write-data"></a><h3>gst_rtsp_watch_write_data ()</h3>
1812
<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a>
1813
gst_rtsp_watch_write_data (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
1814
<em class="parameter"><code>const <span class="type">guint8</span> *data</code></em>,
1815
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>,
1816
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *id</code></em>);</pre>
1817
<p>Write <em class="parameter"><code>data</code></em>
1818
using the connection of the <em class="parameter"><code>watch</code></em>
1819
. If it cannot be sent
1820
immediately, it will be queued for transmission in <em class="parameter"><code>watch</code></em>
1822
<em class="parameter"><code>message</code></em>
1823
will then be serialized and transmitted when the connection of the
1824
<em class="parameter"><code>watch</code></em>
1825
becomes writable. In case the <em class="parameter"><code>message</code></em>
1826
is queued, the ID returned in
1827
<em class="parameter"><code>id</code></em>
1828
will be non-zero and used as the ID argument in the message_sent
1830
<p>This function will take ownership of <em class="parameter"><code>data</code></em>
1831
and <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> it after use.</p>
1832
<p>If the amount of queued data exceeds the limits set with
1833
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-set-send-backlog" title="gst_rtsp_watch_set_send_backlog ()"><code class="function">gst_rtsp_watch_set_send_backlog()</code></a>, this function will return
1834
<a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-ENOMEM:CAPS"><span class="type">GST_RTSP_ENOMEM</span></a>.</p>
1835
<div class="refsect3">
1836
<a name="id-1.2.10.3.8.39.7"></a><h4>Parameters</h4>
1837
<div class="informaltable"><table width="100%" border="0">
1839
<col width="150px" class="parameters_name">
1840
<col class="parameters_description">
1841
<col width="200px" class="parameters_annotations">
1845
<td class="parameter_name"><p>watch</p></td>
1846
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a></p></td>
1847
<td class="parameter_annotations"> </td>
1850
<td class="parameter_name"><p>data</p></td>
1851
<td class="parameter_description"><p> the data to queue. </p></td>
1852
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=size][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
1855
<td class="parameter_name"><p>size</p></td>
1856
<td class="parameter_description"><p>the size of <em class="parameter"><code>data</code></em>
1858
<td class="parameter_annotations"> </td>
1861
<td class="parameter_name"><p>id</p></td>
1862
<td class="parameter_description"><p> location for a message ID or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1863
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1868
<div class="refsect3">
1869
<a name="id-1.2.10.3.8.39.8"></a><h4>Returns</h4>
1870
<p> <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a> on success. <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-ENOMEM:CAPS"><span class="type">GST_RTSP_ENOMEM</span></a> when the backlog limits
1876
<div class="refsect2">
1877
<a name="gst-rtsp-watch-get-send-backlog"></a><h3>gst_rtsp_watch_get_send_backlog ()</h3>
1878
<pre class="programlisting"><span class="returnvalue">void</span>
1879
gst_rtsp_watch_get_send_backlog (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
1880
<em class="parameter"><code><span class="type">gsize</span> *bytes</code></em>,
1881
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *messages</code></em>);</pre>
1882
<p>Get the maximum amount of bytes and messages that will be queued in <em class="parameter"><code>watch</code></em>
1884
See <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-set-send-backlog" title="gst_rtsp_watch_set_send_backlog ()"><code class="function">gst_rtsp_watch_set_send_backlog()</code></a>.</p>
1885
<div class="refsect3">
1886
<a name="id-1.2.10.3.8.40.5"></a><h4>Parameters</h4>
1887
<div class="informaltable"><table width="100%" border="0">
1889
<col width="150px" class="parameters_name">
1890
<col class="parameters_description">
1891
<col width="200px" class="parameters_annotations">
1895
<td class="parameter_name"><p>watch</p></td>
1896
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a></p></td>
1897
<td class="parameter_annotations"> </td>
1900
<td class="parameter_name"><p>bytes</p></td>
1901
<td class="parameter_description"><p> maximum bytes. </p></td>
1902
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1905
<td class="parameter_name"><p>messages</p></td>
1906
<td class="parameter_description"><p> maximum messages. </p></td>
1907
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1912
<p class="since">Since 1.1.1</p>
1915
<div class="refsect2">
1916
<a name="gst-rtsp-watch-set-send-backlog"></a><h3>gst_rtsp_watch_set_send_backlog ()</h3>
1917
<pre class="programlisting"><span class="returnvalue">void</span>
1918
gst_rtsp_watch_set_send_backlog (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a> *watch</code></em>,
1919
<em class="parameter"><code><span class="type">gsize</span> bytes</code></em>,
1920
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> messages</code></em>);</pre>
1921
<p>Set the maximum amount of bytes and messages that will be queued in <em class="parameter"><code>watch</code></em>
1923
When the maximum amounts are exceeded, <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-write-data" title="gst_rtsp_watch_write_data ()"><code class="function">gst_rtsp_watch_write_data()</code></a> and
1924
<a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#gst-rtsp-watch-send-message" title="gst_rtsp_watch_send_message ()"><code class="function">gst_rtsp_watch_send_message()</code></a> will return <a class="link" href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-ENOMEM:CAPS"><span class="type">GST_RTSP_ENOMEM</span></a>.</p>
1925
<p>A value of 0 for <em class="parameter"><code>bytes</code></em>
1926
or <em class="parameter"><code>messages</code></em>
1927
means no limits.</p>
1928
<div class="refsect3">
1929
<a name="id-1.2.10.3.8.41.6"></a><h4>Parameters</h4>
1930
<div class="informaltable"><table width="100%" border="0">
1932
<col width="150px" class="parameters_name">
1933
<col class="parameters_description">
1934
<col width="200px" class="parameters_annotations">
1938
<td class="parameter_name"><p>watch</p></td>
1939
<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-gstrtspconnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a></p></td>
1940
<td class="parameter_annotations"> </td>
1943
<td class="parameter_name"><p>bytes</p></td>
1944
<td class="parameter_description"><p>maximum bytes</p></td>
1945
<td class="parameter_annotations"> </td>
1948
<td class="parameter_name"><p>messages</p></td>
1949
<td class="parameter_description"><p>maximum messages</p></td>
1950
<td class="parameter_annotations"> </td>
1955
<p class="since">Since 1.1.1</p>
1958
<div class="refsect1">
1959
<a name="gst-plugins-base-libs-gstrtspconnection.other_details"></a><h2>Types and Values</h2>
1960
<div class="refsect2">
1961
<a name="GstRTSPConnection"></a><h3>GstRTSPConnection</h3>
1962
<pre class="programlisting">typedef struct _GstRTSPConnection GstRTSPConnection;</pre>
1963
<p>Opaque RTSP connection object.</p>
1222
1966
<div class="refsect2">
1223
1967
<a name="GstRTSPWatch"></a><h3>GstRTSPWatch</h3>
1224
1968
<pre class="programlisting">typedef struct _GstRTSPWatch GstRTSPWatch;</pre>
1226
Opaque RTSP watch object that can be used for asynchronous RTSP
1969
<p>Opaque RTSP watch object that can be used for asynchronous RTSP
1231
1973
<div class="refsect2">