1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3<head> 4<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 5<title>GstRTSPConnection: GStreamer Base Plugins 1.0 Library Reference Manual</title> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="index.html" title="GStreamer Base Plugins 1.0 Library Reference Manual"> 8<link rel="up" href="gstreamer-rtsp.html" title="RTSP Library"> 9<link rel="prev" href="gstreamer-rtsp.html" title="RTSP Library"> 10<link rel="next" href="gst-plugins-base-libs-GstRtspdefs.html" title="GstRtspdefs"> 11<meta name="generator" content="GTK-Doc V1.28 (XML mode)"> 12<link rel="stylesheet" href="style.css" type="text/css"> 13</head> 14<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 15<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> 16<td width="100%" align="left" class="shortcuts"> 17<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 18 <a href="#gst-plugins-base-libs-GstRTSPConnection.description" class="shortcut">Description</a></span> 19</td> 20<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> 21<td><a accesskey="u" href="gstreamer-rtsp.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 22<td><a accesskey="p" href="gstreamer-rtsp.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 23<td><a accesskey="n" href="gst-plugins-base-libs-GstRtspdefs.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> 24</tr></table> 25<div class="refentry"> 26<a name="gst-plugins-base-libs-GstRTSPConnection"></a><div class="titlepage"></div> 27<div class="refnamediv"><table width="100%"><tr> 28<td valign="top"> 29<h2><span class="refentrytitle"><a name="gst-plugins-base-libs-GstRTSPConnection.top_of_page"></a>GstRTSPConnection</span></h2> 30<p>GstRTSPConnection — manage RTSP connections</p> 31</td> 32<td class="gallery_image" valign="top" align="right"></td> 33</tr></table></div> 34<div class="refsect1"> 35<a name="gst-plugins-base-libs-GstRTSPConnection.functions"></a><h2>Functions</h2> 36<div class="informaltable"><table class="informaltable" width="100%" border="0"> 37<colgroup> 38<col width="150px" class="functions_return"> 39<col class="functions_name"> 40</colgroup> 41<tbody> 42<tr> 43<td class="function_type"> 44<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 45</td> 46<td class="function_name"> 47<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> 48</td> 49</tr> 50<tr> 51<td class="function_type"> 52<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 53</td> 54<td class="function_name"> 55<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> 56</td> 57</tr> 58<tr> 59<td class="function_type"> 60<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 61</td> 62<td class="function_name"> 63<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> 64</td> 65</tr> 66<tr> 67<td class="function_type"> 68<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 69</td> 70<td class="function_name"> 71<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> 72</td> 73</tr> 74<tr> 75<td class="function_type"> 76<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 77</td> 78<td class="function_name"> 79<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-connection-connect-with-response" title="gst_rtsp_connection_connect_with_response ()">gst_rtsp_connection_connect_with_response</a> <span class="c_punctuation">()</span> 80</td> 81</tr> 82<tr> 83<td class="function_type"> 84<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 85</td> 86<td class="function_name"> 87<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> 88</td> 89</tr> 90<tr> 91<td class="function_type"> 92<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 93</td> 94<td class="function_name"> 95<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> 96</td> 97</tr> 98<tr> 99<td class="function_type"> 100<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 101</td> 102<td class="function_name"> 103<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> 104</td> 105</tr> 106<tr> 107<td class="function_type"> 108<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 109</td> 110<td class="function_name"> 111<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> 112</td> 113</tr> 114<tr> 115<td class="function_type"> 116<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 117</td> 118<td class="function_name"> 119<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> 120</td> 121</tr> 122<tr> 123<td class="function_type"> 124<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 125</td> 126<td class="function_name"> 127<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> 128</td> 129</tr> 130<tr> 131<td class="function_type"> 132<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 133</td> 134<td class="function_name"> 135<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-connection-send-messages" title="gst_rtsp_connection_send_messages ()">gst_rtsp_connection_send_messages</a> <span class="c_punctuation">()</span> 136</td> 137</tr> 138<tr> 139<td class="function_type"> 140<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 141</td> 142<td class="function_name"> 143<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> 144</td> 145</tr> 146<tr> 147<td class="function_type"> 148<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 149</td> 150<td class="function_name"> 151<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> 152</td> 153</tr> 154<tr> 155<td class="function_type"> 156<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 157</td> 158<td class="function_name"> 159<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> 160</td> 161</tr> 162<tr> 163<td class="function_type"> 164<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 165</td> 166<td class="function_name"> 167<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> 168</td> 169</tr> 170<tr> 171<td class="function_type"> 172<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 173</td> 174<td class="function_name"> 175<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> 176</td> 177</tr> 178<tr> 179<td class="function_type"> 180<span class="returnvalue">void</span> 181</td> 182<td class="function_name"> 183<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> 184</td> 185</tr> 186<tr> 187<td class="function_type"> 188<span class="returnvalue">void</span> 189</td> 190<td class="function_name"> 191<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> 192</td> 193</tr> 194<tr> 195<td class="function_type"> 196<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 197</td> 198<td class="function_name"> 199<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> 200</td> 201</tr> 202<tr> 203<td class="function_type"> 204<span class="returnvalue">void</span> 205</td> 206<td class="function_name"> 207<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> 208</td> 209</tr> 210<tr> 211<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 212</td> 213<td class="function_name"> 214<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> 215</td> 216</tr> 217<tr> 218<td class="function_type"> 219<a class="link" href="GstRTSPUrl.html" title="GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> * 220</td> 221<td class="function_name"> 222<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> 223</td> 224</tr> 225<tr> 226<td class="function_type"> 227<span class="returnvalue">void</span> 228</td> 229<td class="function_name"> 230<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> 231</td> 232</tr> 233<tr> 234<td class="function_type"> 235<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 236</td> 237<td class="function_name"> 238<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> 239</td> 240</tr> 241<tr> 242<td class="function_type">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 243</td> 244<td class="function_name"> 245<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> 246</td> 247</tr> 248<tr> 249<td class="function_type"> 250<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 251</td> 252<td class="function_name"> 253<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> 254</td> 255</tr> 256<tr> 257<td class="function_type"> 258<span class="returnvalue">void</span> 259</td> 260<td class="function_name"> 261<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> 262</td> 263</tr> 264<tr> 265<td class="function_type"> 266<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 267</td> 268<td class="function_name"> 269<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> 270</td> 271</tr> 272<tr> 273<td class="function_type"> 274<a href="/usr/share/gtk-doc/html/gio/GSocket.html#GSocket-struct"><span class="returnvalue">GSocket</span></a> * 275</td> 276<td class="function_name"> 277<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> 278</td> 279</tr> 280<tr> 281<td class="function_type"> 282<a href="/usr/share/gtk-doc/html/gio/GSocket.html#GSocket-struct"><span class="returnvalue">GSocket</span></a> * 283</td> 284<td class="function_name"> 285<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> 286</td> 287</tr> 288<tr> 289<td class="function_type"> 290<a href="/usr/share/gtk-doc/html/gio/GTlsConnection.html#GTlsConnection-struct"><span class="returnvalue">GTlsConnection</span></a> * 291</td> 292<td class="function_name"> 293<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> 294</td> 295</tr> 296<tr> 297<td class="function_type"> 298<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 299</td> 300<td class="function_name"> 301<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> 302</td> 303</tr> 304<tr> 305<td class="function_type"> 306<a href="/usr/share/gtk-doc/html/gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a> 307</td> 308<td class="function_name"> 309<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> 310</td> 311</tr> 312<tr> 313<td class="function_type"> 314<span class="returnvalue">void</span> 315</td> 316<td class="function_name"> 317<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-connection-set-tls-database" title="gst_rtsp_connection_set_tls_database ()">gst_rtsp_connection_set_tls_database</a> <span class="c_punctuation">()</span> 318</td> 319</tr> 320<tr> 321<td class="function_type"> 322<a href="/usr/share/gtk-doc/html/gio/GTlsDatabase.html#GTlsDatabase-struct"><span class="returnvalue">GTlsDatabase</span></a> * 323</td> 324<td class="function_name"> 325<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-connection-get-tls-database" title="gst_rtsp_connection_get_tls_database ()">gst_rtsp_connection_get_tls_database</a> <span class="c_punctuation">()</span> 326</td> 327</tr> 328<tr> 329<td class="function_type"> 330<span class="returnvalue">void</span> 331</td> 332<td class="function_name"> 333<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-connection-set-tls-interaction" title="gst_rtsp_connection_set_tls_interaction ()">gst_rtsp_connection_set_tls_interaction</a> <span class="c_punctuation">()</span> 334</td> 335</tr> 336<tr> 337<td class="function_type"> 338<a href="/usr/share/gtk-doc/html/gio/GTlsInteraction.html#GTlsInteraction-struct"><span class="returnvalue">GTlsInteraction</span></a> * 339</td> 340<td class="function_name"> 341<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-connection-get-tls-interaction" title="gst_rtsp_connection_get_tls_interaction ()">gst_rtsp_connection_get_tls_interaction</a> <span class="c_punctuation">()</span> 342</td> 343</tr> 344<tr> 345<td class="function_type"> 346<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 347</td> 348<td class="function_name"> 349<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-connection-get-remember-session-id" title="gst_rtsp_connection_get_remember_session_id ()">gst_rtsp_connection_get_remember_session_id</a> <span class="c_punctuation">()</span> 350</td> 351</tr> 352<tr> 353<td class="function_type"> 354<span class="returnvalue">void</span> 355</td> 356<td class="function_name"> 357<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-connection-set-remember-session-id" title="gst_rtsp_connection_set_remember_session_id ()">gst_rtsp_connection_set_remember_session_id</a> <span class="c_punctuation">()</span> 358</td> 359</tr> 360<tr> 361<td class="function_type"> 362<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 363</td> 364<td class="function_name"> 365<span class="c_punctuation">(</span><a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPConnectionAcceptCertificateFunc" title="GstRTSPConnectionAcceptCertificateFunc ()">*GstRTSPConnectionAcceptCertificateFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span> 366</td> 367</tr> 368<tr> 369<td class="function_type"> 370<span class="returnvalue">void</span> 371</td> 372<td class="function_name"> 373<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-connection-set-accept-certificate-func" title="gst_rtsp_connection_set_accept_certificate_func ()">gst_rtsp_connection_set_accept_certificate_func</a> <span class="c_punctuation">()</span> 374</td> 375</tr> 376<tr> 377<td class="function_type"> 378<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="returnvalue">GstRTSPWatch</span></a> * 379</td> 380<td class="function_name"> 381<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> 382</td> 383</tr> 384<tr> 385<td class="function_type"> 386<span class="returnvalue">void</span> 387</td> 388<td class="function_name"> 389<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> 390</td> 391</tr> 392<tr> 393<td class="function_type"> 394<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> 395</td> 396<td class="function_name"> 397<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> 398</td> 399</tr> 400<tr> 401<td class="function_type"> 402<span class="returnvalue">void</span> 403</td> 404<td class="function_name"> 405<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> 406</td> 407</tr> 408<tr> 409<td class="function_type"> 410<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 411</td> 412<td class="function_name"> 413<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> 414</td> 415</tr> 416<tr> 417<td class="function_type"> 418<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 419</td> 420<td class="function_name"> 421<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-watch-send-messages" title="gst_rtsp_watch_send_messages ()">gst_rtsp_watch_send_messages</a> <span class="c_punctuation">()</span> 422</td> 423</tr> 424<tr> 425<td class="function_type"> 426<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 427</td> 428<td class="function_name"> 429<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> 430</td> 431</tr> 432<tr> 433<td class="function_type"> 434<span class="returnvalue">void</span> 435</td> 436<td class="function_name"> 437<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> 438</td> 439</tr> 440<tr> 441<td class="function_type"> 442<span class="returnvalue">void</span> 443</td> 444<td class="function_name"> 445<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> 446</td> 447</tr> 448<tr> 449<td class="function_type"> 450<span class="returnvalue">void</span> 451</td> 452<td class="function_name"> 453<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-watch-set-flushing" title="gst_rtsp_watch_set_flushing ()">gst_rtsp_watch_set_flushing</a> <span class="c_punctuation">()</span> 454</td> 455</tr> 456<tr> 457<td class="function_type"> 458<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 459</td> 460<td class="function_name"> 461<a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-watch-wait-backlog" title="gst_rtsp_watch_wait_backlog ()">gst_rtsp_watch_wait_backlog</a> <span class="c_punctuation">()</span> 462</td> 463</tr> 464</tbody> 465</table></div> 466</div> 467<div class="refsect1"> 468<a name="gst-plugins-base-libs-GstRTSPConnection.other"></a><h2>Types and Values</h2> 469<div class="informaltable"><table class="informaltable" width="100%" border="0"> 470<colgroup> 471<col width="150px" class="name"> 472<col class="description"> 473</colgroup> 474<tbody> 475<tr> 476<td class="datatype_keyword"> </td> 477<td class="function_name"><a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPConnection" title="GstRTSPConnection">GstRTSPConnection</a></td> 478</tr> 479<tr> 480<td class="datatype_keyword"> </td> 481<td class="function_name"><a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPWatch" title="GstRTSPWatch">GstRTSPWatch</a></td> 482</tr> 483<tr> 484<td class="datatype_keyword"> </td> 485<td class="function_name"><a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPWatchFuncs" title="GstRTSPWatchFuncs">GstRTSPWatchFuncs</a></td> 486</tr> 487</tbody> 488</table></div> 489</div> 490<div class="refsect1"> 491<a name="gst-plugins-base-libs-GstRTSPConnection.includes"></a><h2>Includes</h2> 492<pre class="synopsis">#include <gst/rtsp/rtsp.h> 493</pre> 494</div> 495<div class="refsect1"> 496<a name="gst-plugins-base-libs-GstRTSPConnection.description"></a><h2>Description</h2> 497<p>This object manages the RTSP connection to the server. It provides function 498to receive and send bytes and messages.</p> 499</div> 500<div class="refsect1"> 501<a name="gst-plugins-base-libs-GstRTSPConnection.functions_details"></a><h2>Functions</h2> 502<div class="refsect2"> 503<a name="gst-rtsp-connection-create"></a><h3>gst_rtsp_connection_create ()</h3> 504<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 505gst_rtsp_connection_create (<em class="parameter"><code>const <a class="link" href="GstRTSPUrl.html" title="GstRTSPUrl"><span class="type">GstRTSPUrl</span></a> *url</code></em>, 506 <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> 507<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> 508 and store it in <em class="parameter"><code>conn</code></em> 509. 510The connection will not yet attempt to connect to <em class="parameter"><code>url</code></em> 511, use 512<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> 513<p>A copy of <em class="parameter"><code>url</code></em> 514 will be made.</p> 515<div class="refsect3"> 516<a name="gst-rtsp-connection-create.parameters"></a><h4>Parameters</h4> 517<div class="informaltable"><table class="informaltable" width="100%" border="0"> 518<colgroup> 519<col width="150px" class="parameters_name"> 520<col class="parameters_description"> 521<col width="200px" class="parameters_annotations"> 522</colgroup> 523<tbody> 524<tr> 525<td class="parameter_name"><p>url</p></td> 526<td class="parameter_description"><p>a <a class="link" href="GstRTSPUrl.html" title="GstRTSPUrl"><span class="type">GstRTSPUrl</span></a></p></td> 527<td class="parameter_annotations"> </td> 528</tr> 529<tr> 530<td class="parameter_name"><p>conn</p></td> 531<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> 532<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> 533</tr> 534</tbody> 535</table></div> 536</div> 537<div class="refsect3"> 538<a name="gst-rtsp-connection-create.returns"></a><h4>Returns</h4> 539<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> 540contains a valid connection.</p> 541</div> 542</div> 543<hr> 544<div class="refsect2"> 545<a name="gst-rtsp-connection-create-from-socket"></a><h3>gst_rtsp_connection_create_from_socket ()</h3> 546<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 547gst_rtsp_connection_create_from_socket 548 (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GSocket.html#GSocket-struct"><span class="type">GSocket</span></a> *socket</code></em>, 549 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ip</code></em>, 550 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> port</code></em>, 551 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *initial_buffer</code></em>, 552 <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> 553<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 554socket <em class="parameter"><code>socket</code></em> 555. The <em class="parameter"><code>initial_buffer</code></em> 556 contains zero terminated data already 557read from <em class="parameter"><code>socket</code></em> 558 which should be used before starting to read new data.</p> 559<div class="refsect3"> 560<a name="gst-rtsp-connection-create-from-socket.parameters"></a><h4>Parameters</h4> 561<div class="informaltable"><table class="informaltable" width="100%" border="0"> 562<colgroup> 563<col width="150px" class="parameters_name"> 564<col class="parameters_description"> 565<col width="200px" class="parameters_annotations"> 566</colgroup> 567<tbody> 568<tr> 569<td class="parameter_name"><p>socket</p></td> 570<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gio/GSocket.html#GSocket-struct"><span class="type">GSocket</span></a></p></td> 571<td class="parameter_annotations"> </td> 572</tr> 573<tr> 574<td class="parameter_name"><p>ip</p></td> 575<td class="parameter_description"><p>the IP address of the other end</p></td> 576<td class="parameter_annotations"> </td> 577</tr> 578<tr> 579<td class="parameter_name"><p>port</p></td> 580<td class="parameter_description"><p>the port used by the other end</p></td> 581<td class="parameter_annotations"> </td> 582</tr> 583<tr> 584<td class="parameter_name"><p>initial_buffer</p></td> 585<td class="parameter_description"><p>data already read from <em class="parameter"><code>fd</code></em> 586</p></td> 587<td class="parameter_annotations"> </td> 588</tr> 589<tr> 590<td class="parameter_name"><p>conn</p></td> 591<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> 592<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> 593</tr> 594</tbody> 595</table></div> 596</div> 597<div class="refsect3"> 598<a name="gst-rtsp-connection-create-from-socket.returns"></a><h4>Returns</h4> 599<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> 600contains a valid connection.</p> 601</div> 602</div> 603<hr> 604<div class="refsect2"> 605<a name="gst-rtsp-connection-accept"></a><h3>gst_rtsp_connection_accept ()</h3> 606<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 607gst_rtsp_connection_accept (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GSocket.html#GSocket-struct"><span class="type">GSocket</span></a> *socket</code></em>, 608 <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>, 609 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>);</pre> 610<p>Accept a new connection on <em class="parameter"><code>socket</code></em> 611 and create a new <a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> for 612handling communication on new socket.</p> 613<div class="refsect3"> 614<a name="gst-rtsp-connection-accept.parameters"></a><h4>Parameters</h4> 615<div class="informaltable"><table class="informaltable" width="100%" border="0"> 616<colgroup> 617<col width="150px" class="parameters_name"> 618<col class="parameters_description"> 619<col width="200px" class="parameters_annotations"> 620</colgroup> 621<tbody> 622<tr> 623<td class="parameter_name"><p>socket</p></td> 624<td class="parameter_description"><p>a socket</p></td> 625<td class="parameter_annotations"> </td> 626</tr> 627<tr> 628<td class="parameter_name"><p>conn</p></td> 629<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> 630<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> 631</tr> 632<tr> 633<td class="parameter_name"><p>cancellable</p></td> 634<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> to cancel the operation</p></td> 635<td class="parameter_annotations"> </td> 636</tr> 637</tbody> 638</table></div> 639</div> 640<div class="refsect3"> 641<a name="gst-rtsp-connection-accept.returns"></a><h4>Returns</h4> 642<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> 643contains a valid connection.</p> 644</div> 645</div> 646<hr> 647<div class="refsect2"> 648<a name="gst-rtsp-connection-connect"></a><h3>gst_rtsp_connection_connect ()</h3> 649<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 650gst_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>, 651 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre> 652<p>Attempt to connect to the url of <em class="parameter"><code>conn</code></em> 653 made with 654<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> 655 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> this function can block 656forever. If <em class="parameter"><code>timeout</code></em> 657 contains a valid timeout, this function will return 658<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> 659<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> 660<div class="refsect3"> 661<a name="gst-rtsp-connection-connect.parameters"></a><h4>Parameters</h4> 662<div class="informaltable"><table class="informaltable" width="100%" border="0"> 663<colgroup> 664<col width="150px" class="parameters_name"> 665<col class="parameters_description"> 666<col width="200px" class="parameters_annotations"> 667</colgroup> 668<tbody> 669<tr> 670<td class="parameter_name"><p>conn</p></td> 671<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> 672<td class="parameter_annotations"> </td> 673</tr> 674<tr> 675<td class="parameter_name"><p>timeout</p></td> 676<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> timeout</p></td> 677<td class="parameter_annotations"> </td> 678</tr> 679</tbody> 680</table></div> 681</div> 682<div class="refsect3"> 683<a name="gst-rtsp-connection-connect.returns"></a><h4>Returns</h4> 684<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> 685</div> 686</div> 687<hr> 688<div class="refsect2"> 689<a name="gst-rtsp-connection-connect-with-response"></a><h3>gst_rtsp_connection_connect_with_response ()</h3> 690<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 691gst_rtsp_connection_connect_with_response 692 (<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>, 693 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>, 694 <em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *response</code></em>);</pre> 695<p>Attempt to connect to the url of <em class="parameter"><code>conn</code></em> 696 made with 697<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> 698 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> this function can block 699forever. If <em class="parameter"><code>timeout</code></em> 700 contains a valid timeout, this function will return 701<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. If <em class="parameter"><code>conn</code></em> 702 is set to tunneled, 703<em class="parameter"><code>response</code></em> 704 will contain a response to the tunneling request messages.</p> 705<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> 706<div class="refsect3"> 707<a name="gst-rtsp-connection-connect-with-response.parameters"></a><h4>Parameters</h4> 708<div class="informaltable"><table class="informaltable" width="100%" border="0"> 709<colgroup> 710<col width="150px" class="parameters_name"> 711<col class="parameters_description"> 712<col width="200px" class="parameters_annotations"> 713</colgroup> 714<tbody> 715<tr> 716<td class="parameter_name"><p>conn</p></td> 717<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> 718<td class="parameter_annotations"> </td> 719</tr> 720<tr> 721<td class="parameter_name"><p>timeout</p></td> 722<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> timeout</p></td> 723<td class="parameter_annotations"> </td> 724</tr> 725<tr> 726<td class="parameter_name"><p>response</p></td> 727<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 728<td class="parameter_annotations"> </td> 729</tr> 730</tbody> 731</table></div> 732</div> 733<div class="refsect3"> 734<a name="gst-rtsp-connection-connect-with-response.returns"></a><h4>Returns</h4> 735<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> 736</div> 737<p class="since">Since: <a class="link" href="ix08.html#api-index-1.8">1.8</a></p> 738</div> 739<hr> 740<div class="refsect2"> 741<a name="gst-rtsp-connection-close"></a><h3>gst_rtsp_connection_close ()</h3> 742<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 743gst_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> 744<p>Close the connected <em class="parameter"><code>conn</code></em> 745. After this call, the connection is in the same 746state as when it was first created.</p> 747<div class="refsect3"> 748<a name="gst-rtsp-connection-close.parameters"></a><h4>Parameters</h4> 749<div class="informaltable"><table class="informaltable" width="100%" border="0"> 750<colgroup> 751<col width="150px" class="parameters_name"> 752<col class="parameters_description"> 753<col width="200px" class="parameters_annotations"> 754</colgroup> 755<tbody><tr> 756<td class="parameter_name"><p>conn</p></td> 757<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> 758<td class="parameter_annotations"> </td> 759</tr></tbody> 760</table></div> 761</div> 762<div class="refsect3"> 763<a name="gst-rtsp-connection-close.returns"></a><h4>Returns</h4> 764<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> 765</div> 766</div> 767<hr> 768<div class="refsect2"> 769<a name="gst-rtsp-connection-free"></a><h3>gst_rtsp_connection_free ()</h3> 770<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 771gst_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> 772<p>Close and free <em class="parameter"><code>conn</code></em> 773.</p> 774<div class="refsect3"> 775<a name="gst-rtsp-connection-free.parameters"></a><h4>Parameters</h4> 776<div class="informaltable"><table class="informaltable" width="100%" border="0"> 777<colgroup> 778<col width="150px" class="parameters_name"> 779<col class="parameters_description"> 780<col width="200px" class="parameters_annotations"> 781</colgroup> 782<tbody><tr> 783<td class="parameter_name"><p>conn</p></td> 784<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> 785<td class="parameter_annotations"> </td> 786</tr></tbody> 787</table></div> 788</div> 789<div class="refsect3"> 790<a name="gst-rtsp-connection-free.returns"></a><h4>Returns</h4> 791<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> 792</div> 793</div> 794<hr> 795<div class="refsect2"> 796<a name="gst-rtsp-connection-read"></a><h3>gst_rtsp_connection_read ()</h3> 797<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 798gst_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>, 799 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *data</code></em>, 800 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>, 801 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre> 802<p>Attempt to read <em class="parameter"><code>size</code></em> 803 bytes into <em class="parameter"><code>data</code></em> 804 from the connected <em class="parameter"><code>conn</code></em> 805, blocking up to 806the specified <em class="parameter"><code>timeout</code></em> 807. <em class="parameter"><code>timeout</code></em> 808 can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, in which case this function 809might block forever.</p> 810<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> 811<div class="refsect3"> 812<a name="gst-rtsp-connection-read.parameters"></a><h4>Parameters</h4> 813<div class="informaltable"><table class="informaltable" width="100%" border="0"> 814<colgroup> 815<col width="150px" class="parameters_name"> 816<col class="parameters_description"> 817<col width="200px" class="parameters_annotations"> 818</colgroup> 819<tbody> 820<tr> 821<td class="parameter_name"><p>conn</p></td> 822<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> 823<td class="parameter_annotations"> </td> 824</tr> 825<tr> 826<td class="parameter_name"><p>data</p></td> 827<td class="parameter_description"><p>the data to read</p></td> 828<td class="parameter_annotations"> </td> 829</tr> 830<tr> 831<td class="parameter_name"><p>size</p></td> 832<td class="parameter_description"><p>the size of <em class="parameter"><code>data</code></em> 833</p></td> 834<td class="parameter_annotations"> </td> 835</tr> 836<tr> 837<td class="parameter_name"><p>timeout</p></td> 838<td class="parameter_description"><p>a timeout value or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> 839<td class="parameter_annotations"> </td> 840</tr> 841</tbody> 842</table></div> 843</div> 844<div class="refsect3"> 845<a name="gst-rtsp-connection-read.returns"></a><h4>Returns</h4> 846<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> 847</div> 848</div> 849<hr> 850<div class="refsect2"> 851<a name="gst-rtsp-connection-write"></a><h3>gst_rtsp_connection_write ()</h3> 852<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 853gst_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>, 854 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *data</code></em>, 855 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>, 856 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre> 857<p>Attempt to write <em class="parameter"><code>size</code></em> 858 bytes of <em class="parameter"><code>data</code></em> 859 to the connected <em class="parameter"><code>conn</code></em> 860, blocking up to 861the specified <em class="parameter"><code>timeout</code></em> 862. <em class="parameter"><code>timeout</code></em> 863 can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, in which case this function 864might block forever.</p> 865<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> 866<div class="refsect3"> 867<a name="gst-rtsp-connection-write.parameters"></a><h4>Parameters</h4> 868<div class="informaltable"><table class="informaltable" width="100%" border="0"> 869<colgroup> 870<col width="150px" class="parameters_name"> 871<col class="parameters_description"> 872<col width="200px" class="parameters_annotations"> 873</colgroup> 874<tbody> 875<tr> 876<td class="parameter_name"><p>conn</p></td> 877<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> 878<td class="parameter_annotations"> </td> 879</tr> 880<tr> 881<td class="parameter_name"><p>data</p></td> 882<td class="parameter_description"><p>the data to write</p></td> 883<td class="parameter_annotations"> </td> 884</tr> 885<tr> 886<td class="parameter_name"><p>size</p></td> 887<td class="parameter_description"><p>the size of <em class="parameter"><code>data</code></em> 888</p></td> 889<td class="parameter_annotations"> </td> 890</tr> 891<tr> 892<td class="parameter_name"><p>timeout</p></td> 893<td class="parameter_description"><p>a timeout value or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> 894<td class="parameter_annotations"> </td> 895</tr> 896</tbody> 897</table></div> 898</div> 899<div class="refsect3"> 900<a name="gst-rtsp-connection-write.returns"></a><h4>Returns</h4> 901<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> 902</div> 903</div> 904<hr> 905<div class="refsect2"> 906<a name="gst-rtsp-connection-poll"></a><h3>gst_rtsp_connection_poll ()</h3> 907<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 908gst_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>, 909 <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>, 910 <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>, 911 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre> 912<p>Wait up to the specified <em class="parameter"><code>timeout</code></em> 913 for the connection to become available for 914at least one of the operations specified in <em class="parameter"><code>events</code></em> 915. When the function returns 916with <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> 917 will contain a bitmask of available operations on 918<em class="parameter"><code>conn</code></em> 919.</p> 920<p><em class="parameter"><code>timeout</code></em> 921 can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, in which case this function might block forever.</p> 922<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> 923<div class="refsect3"> 924<a name="gst-rtsp-connection-poll.parameters"></a><h4>Parameters</h4> 925<div class="informaltable"><table class="informaltable" width="100%" border="0"> 926<colgroup> 927<col width="150px" class="parameters_name"> 928<col class="parameters_description"> 929<col width="200px" class="parameters_annotations"> 930</colgroup> 931<tbody> 932<tr> 933<td class="parameter_name"><p>conn</p></td> 934<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> 935<td class="parameter_annotations"> </td> 936</tr> 937<tr> 938<td class="parameter_name"><p>events</p></td> 939<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> 940<td class="parameter_annotations"> </td> 941</tr> 942<tr> 943<td class="parameter_name"><p>revents</p></td> 944<td class="parameter_description"><p>location for result flags</p></td> 945<td class="parameter_annotations"> </td> 946</tr> 947<tr> 948<td class="parameter_name"><p>timeout</p></td> 949<td class="parameter_description"><p>a timeout</p></td> 950<td class="parameter_annotations"> </td> 951</tr> 952</tbody> 953</table></div> 954</div> 955<div class="refsect3"> 956<a name="gst-rtsp-connection-poll.returns"></a><h4>Returns</h4> 957<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> 958</div> 959</div> 960<hr> 961<div class="refsect2"> 962<a name="gst-rtsp-connection-send"></a><h3>gst_rtsp_connection_send ()</h3> 963<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 964gst_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>, 965 <em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>, 966 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre> 967<p>Attempt to send <em class="parameter"><code>message</code></em> 968 to the connected <em class="parameter"><code>conn</code></em> 969, blocking up to 970the specified <em class="parameter"><code>timeout</code></em> 971. <em class="parameter"><code>timeout</code></em> 972 can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, in which case this function 973might block forever.</p> 974<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> 975<div class="refsect3"> 976<a name="gst-rtsp-connection-send.parameters"></a><h4>Parameters</h4> 977<div class="informaltable"><table class="informaltable" width="100%" border="0"> 978<colgroup> 979<col width="150px" class="parameters_name"> 980<col class="parameters_description"> 981<col width="200px" class="parameters_annotations"> 982</colgroup> 983<tbody> 984<tr> 985<td class="parameter_name"><p>conn</p></td> 986<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> 987<td class="parameter_annotations"> </td> 988</tr> 989<tr> 990<td class="parameter_name"><p>message</p></td> 991<td class="parameter_description"><p>the message to send</p></td> 992<td class="parameter_annotations"> </td> 993</tr> 994<tr> 995<td class="parameter_name"><p>timeout</p></td> 996<td class="parameter_description"><p>a timeout value or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> 997<td class="parameter_annotations"> </td> 998</tr> 999</tbody> 1000</table></div> 1001</div> 1002<div class="refsect3"> 1003<a name="gst-rtsp-connection-send.returns"></a><h4>Returns</h4> 1004<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> 1005</div> 1006</div> 1007<hr> 1008<div class="refsect2"> 1009<a name="gst-rtsp-connection-send-messages"></a><h3>gst_rtsp_connection_send_messages ()</h3> 1010<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1011gst_rtsp_connection_send_messages (<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>, 1012 <em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *messages</code></em>, 1013 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_messages</code></em>, 1014 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre> 1015<p>Attempt to send <em class="parameter"><code>messages</code></em> 1016 to the connected <em class="parameter"><code>conn</code></em> 1017, blocking up to 1018the specified <em class="parameter"><code>timeout</code></em> 1019. <em class="parameter"><code>timeout</code></em> 1020 can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, in which case this function 1021might block forever.</p> 1022<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> 1023<div class="refsect3"> 1024<a name="gst-rtsp-connection-send-messages.parameters"></a><h4>Parameters</h4> 1025<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1026<colgroup> 1027<col width="150px" class="parameters_name"> 1028<col class="parameters_description"> 1029<col width="200px" class="parameters_annotations"> 1030</colgroup> 1031<tbody> 1032<tr> 1033<td class="parameter_name"><p>conn</p></td> 1034<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> 1035<td class="parameter_annotations"> </td> 1036</tr> 1037<tr> 1038<td class="parameter_name"><p>messages</p></td> 1039<td class="parameter_description"><p>the messages to send. </p></td> 1040<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_messages]</span></td> 1041</tr> 1042<tr> 1043<td class="parameter_name"><p>n_messages</p></td> 1044<td class="parameter_description"><p>the number of messages to send</p></td> 1045<td class="parameter_annotations"> </td> 1046</tr> 1047<tr> 1048<td class="parameter_name"><p>timeout</p></td> 1049<td class="parameter_description"><p>a timeout value or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> 1050<td class="parameter_annotations"> </td> 1051</tr> 1052</tbody> 1053</table></div> 1054</div> 1055<div class="refsect3"> 1056<a name="gst-rtsp-connection-send-messages.returns"></a><h4>Returns</h4> 1057<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> 1058</div> 1059<p class="since">Since: <a class="link" href="ix03.html#api-index-1.16">1.16</a></p> 1060</div> 1061<hr> 1062<div class="refsect2"> 1063<a name="gst-rtsp-connection-receive"></a><h3>gst_rtsp_connection_receive ()</h3> 1064<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1065gst_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>, 1066 <em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>, 1067 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre> 1068<p>Attempt to read into <em class="parameter"><code>message</code></em> 1069 from the connected <em class="parameter"><code>conn</code></em> 1070, blocking up to 1071the specified <em class="parameter"><code>timeout</code></em> 1072. <em class="parameter"><code>timeout</code></em> 1073 can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, in which case this function 1074might block forever.</p> 1075<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> 1076<div class="refsect3"> 1077<a name="gst-rtsp-connection-receive.parameters"></a><h4>Parameters</h4> 1078<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1079<colgroup> 1080<col width="150px" class="parameters_name"> 1081<col class="parameters_description"> 1082<col width="200px" class="parameters_annotations"> 1083</colgroup> 1084<tbody> 1085<tr> 1086<td class="parameter_name"><p>conn</p></td> 1087<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> 1088<td class="parameter_annotations"> </td> 1089</tr> 1090<tr> 1091<td class="parameter_name"><p>message</p></td> 1092<td class="parameter_description"><p>the message to read</p></td> 1093<td class="parameter_annotations"> </td> 1094</tr> 1095<tr> 1096<td class="parameter_name"><p>timeout</p></td> 1097<td class="parameter_description"><p>a timeout value or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> 1098<td class="parameter_annotations"> </td> 1099</tr> 1100</tbody> 1101</table></div> 1102</div> 1103<div class="refsect3"> 1104<a name="gst-rtsp-connection-receive.returns"></a><h4>Returns</h4> 1105<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> 1106</div> 1107</div> 1108<hr> 1109<div class="refsect2"> 1110<a name="gst-rtsp-connection-next-timeout"></a><h3>gst_rtsp_connection_next_timeout ()</h3> 1111<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1112gst_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>, 1113 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre> 1114<p>Calculate the next timeout for <em class="parameter"><code>conn</code></em> 1115, storing the result in <em class="parameter"><code>timeout</code></em> 1116.</p> 1117<div class="refsect3"> 1118<a name="gst-rtsp-connection-next-timeout.parameters"></a><h4>Parameters</h4> 1119<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1120<colgroup> 1121<col width="150px" class="parameters_name"> 1122<col class="parameters_description"> 1123<col width="200px" class="parameters_annotations"> 1124</colgroup> 1125<tbody> 1126<tr> 1127<td class="parameter_name"><p>conn</p></td> 1128<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> 1129<td class="parameter_annotations"> </td> 1130</tr> 1131<tr> 1132<td class="parameter_name"><p>timeout</p></td> 1133<td class="parameter_description"><p>a timeout</p></td> 1134<td class="parameter_annotations"> </td> 1135</tr> 1136</tbody> 1137</table></div> 1138</div> 1139<div class="refsect3"> 1140<a name="gst-rtsp-connection-next-timeout.returns"></a><h4>Returns</h4> 1141<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1142</div> 1143</div> 1144<hr> 1145<div class="refsect2"> 1146<a name="gst-rtsp-connection-reset-timeout"></a><h3>gst_rtsp_connection_reset_timeout ()</h3> 1147<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1148gst_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> 1149<p>Reset the timeout of <em class="parameter"><code>conn</code></em> 1150.</p> 1151<div class="refsect3"> 1152<a name="gst-rtsp-connection-reset-timeout.parameters"></a><h4>Parameters</h4> 1153<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1154<colgroup> 1155<col width="150px" class="parameters_name"> 1156<col class="parameters_description"> 1157<col width="200px" class="parameters_annotations"> 1158</colgroup> 1159<tbody><tr> 1160<td class="parameter_name"><p>conn</p></td> 1161<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> 1162<td class="parameter_annotations"> </td> 1163</tr></tbody> 1164</table></div> 1165</div> 1166<div class="refsect3"> 1167<a name="gst-rtsp-connection-reset-timeout.returns"></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>.</p> 1169</div> 1170</div> 1171<hr> 1172<div class="refsect2"> 1173<a name="gst-rtsp-connection-flush"></a><h3>gst_rtsp_connection_flush ()</h3> 1174<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1175gst_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>, 1176 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> flush</code></em>);</pre> 1177<p>Start or stop the flushing action on <em class="parameter"><code>conn</code></em> 1178. When flushing, all current 1179and future actions on <em class="parameter"><code>conn</code></em> 1180 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 1181is set to non-flushing mode again.</p> 1182<div class="refsect3"> 1183<a name="gst-rtsp-connection-flush.parameters"></a><h4>Parameters</h4> 1184<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1185<colgroup> 1186<col width="150px" class="parameters_name"> 1187<col class="parameters_description"> 1188<col width="200px" class="parameters_annotations"> 1189</colgroup> 1190<tbody> 1191<tr> 1192<td class="parameter_name"><p>conn</p></td> 1193<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> 1194<td class="parameter_annotations"> </td> 1195</tr> 1196<tr> 1197<td class="parameter_name"><p>flush</p></td> 1198<td class="parameter_description"><p>start or stop the flush</p></td> 1199<td class="parameter_annotations"> </td> 1200</tr> 1201</tbody> 1202</table></div> 1203</div> 1204<div class="refsect3"> 1205<a name="gst-rtsp-connection-flush.returns"></a><h4>Returns</h4> 1206<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1207</div> 1208</div> 1209<hr> 1210<div class="refsect2"> 1211<a name="gst-rtsp-connection-set-auth"></a><h3>gst_rtsp_connection_set_auth ()</h3> 1212<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1213gst_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>, 1214 <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>, 1215 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *user</code></em>, 1216 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pass</code></em>);</pre> 1217<p>Configure <em class="parameter"><code>conn</code></em> 1218 for authentication mode <em class="parameter"><code>method</code></em> 1219 with <em class="parameter"><code>user</code></em> 1220 and <em class="parameter"><code>pass</code></em> 1221 as the 1222user and password respectively.</p> 1223<div class="refsect3"> 1224<a name="gst-rtsp-connection-set-auth.parameters"></a><h4>Parameters</h4> 1225<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1226<colgroup> 1227<col width="150px" class="parameters_name"> 1228<col class="parameters_description"> 1229<col width="200px" class="parameters_annotations"> 1230</colgroup> 1231<tbody> 1232<tr> 1233<td class="parameter_name"><p>conn</p></td> 1234<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> 1235<td class="parameter_annotations"> </td> 1236</tr> 1237<tr> 1238<td class="parameter_name"><p>method</p></td> 1239<td class="parameter_description"><p>authentication method</p></td> 1240<td class="parameter_annotations"> </td> 1241</tr> 1242<tr> 1243<td class="parameter_name"><p>user</p></td> 1244<td class="parameter_description"><p>the user</p></td> 1245<td class="parameter_annotations"> </td> 1246</tr> 1247<tr> 1248<td class="parameter_name"><p>pass</p></td> 1249<td class="parameter_description"><p>the password</p></td> 1250<td class="parameter_annotations"> </td> 1251</tr> 1252</tbody> 1253</table></div> 1254</div> 1255<div class="refsect3"> 1256<a name="gst-rtsp-connection-set-auth.returns"></a><h4>Returns</h4> 1257<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1258</div> 1259</div> 1260<hr> 1261<div class="refsect2"> 1262<a name="gst-rtsp-connection-set-auth-param"></a><h3>gst_rtsp_connection_set_auth_param ()</h3> 1263<pre class="programlisting"><span class="returnvalue">void</span> 1264gst_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>, 1265 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *param</code></em>, 1266 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre> 1267<p>Setup <em class="parameter"><code>conn</code></em> 1268 with authentication directives. This is not necesary for 1269methods <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 1270<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 1271in the WWW-Authenticate response header and can include realm, domain, 1272nonce, opaque, stale, algorithm, qop as per RFC2617.</p> 1273<div class="refsect3"> 1274<a name="gst-rtsp-connection-set-auth-param.parameters"></a><h4>Parameters</h4> 1275<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1276<colgroup> 1277<col width="150px" class="parameters_name"> 1278<col class="parameters_description"> 1279<col width="200px" class="parameters_annotations"> 1280</colgroup> 1281<tbody> 1282<tr> 1283<td class="parameter_name"><p>conn</p></td> 1284<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> 1285<td class="parameter_annotations"> </td> 1286</tr> 1287<tr> 1288<td class="parameter_name"><p>param</p></td> 1289<td class="parameter_description"><p>authentication directive</p></td> 1290<td class="parameter_annotations"> </td> 1291</tr> 1292<tr> 1293<td class="parameter_name"><p>value</p></td> 1294<td class="parameter_description"><p>value</p></td> 1295<td class="parameter_annotations"> </td> 1296</tr> 1297</tbody> 1298</table></div> 1299</div> 1300</div> 1301<hr> 1302<div class="refsect2"> 1303<a name="gst-rtsp-connection-clear-auth-params"></a><h3>gst_rtsp_connection_clear_auth_params ()</h3> 1304<pre class="programlisting"><span class="returnvalue">void</span> 1305gst_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> 1306<p>Clear the list of authentication directives stored in <em class="parameter"><code>conn</code></em> 1307.</p> 1308<div class="refsect3"> 1309<a name="gst-rtsp-connection-clear-auth-params.parameters"></a><h4>Parameters</h4> 1310<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1311<colgroup> 1312<col width="150px" class="parameters_name"> 1313<col class="parameters_description"> 1314<col width="200px" class="parameters_annotations"> 1315</colgroup> 1316<tbody><tr> 1317<td class="parameter_name"><p>conn</p></td> 1318<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> 1319<td class="parameter_annotations"> </td> 1320</tr></tbody> 1321</table></div> 1322</div> 1323</div> 1324<hr> 1325<div class="refsect2"> 1326<a name="gst-rtsp-connection-set-qos-dscp"></a><h3>gst_rtsp_connection_set_qos_dscp ()</h3> 1327<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1328gst_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>, 1329 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> qos_dscp</code></em>);</pre> 1330<p>Configure <em class="parameter"><code>conn</code></em> 1331 to use the specified DSCP value.</p> 1332<div class="refsect3"> 1333<a name="gst-rtsp-connection-set-qos-dscp.parameters"></a><h4>Parameters</h4> 1334<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1335<colgroup> 1336<col width="150px" class="parameters_name"> 1337<col class="parameters_description"> 1338<col width="200px" class="parameters_annotations"> 1339</colgroup> 1340<tbody> 1341<tr> 1342<td class="parameter_name"><p>conn</p></td> 1343<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> 1344<td class="parameter_annotations"> </td> 1345</tr> 1346<tr> 1347<td class="parameter_name"><p>qos_dscp</p></td> 1348<td class="parameter_description"><p>DSCP value</p></td> 1349<td class="parameter_annotations"> </td> 1350</tr> 1351</tbody> 1352</table></div> 1353</div> 1354<div class="refsect3"> 1355<a name="gst-rtsp-connection-set-qos-dscp.returns"></a><h4>Returns</h4> 1356<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> 1357</div> 1358</div> 1359<hr> 1360<div class="refsect2"> 1361<a name="gst-rtsp-connection-set-ip"></a><h3>gst_rtsp_connection_set_ip ()</h3> 1362<pre class="programlisting"><span class="returnvalue">void</span> 1363gst_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>, 1364 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ip</code></em>);</pre> 1365<p>Set the IP address of the server.</p> 1366<div class="refsect3"> 1367<a name="gst-rtsp-connection-set-ip.parameters"></a><h4>Parameters</h4> 1368<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1369<colgroup> 1370<col width="150px" class="parameters_name"> 1371<col class="parameters_description"> 1372<col width="200px" class="parameters_annotations"> 1373</colgroup> 1374<tbody> 1375<tr> 1376<td class="parameter_name"><p>conn</p></td> 1377<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> 1378<td class="parameter_annotations"> </td> 1379</tr> 1380<tr> 1381<td class="parameter_name"><p>ip</p></td> 1382<td class="parameter_description"><p>an ip address</p></td> 1383<td class="parameter_annotations"> </td> 1384</tr> 1385</tbody> 1386</table></div> 1387</div> 1388</div> 1389<hr> 1390<div class="refsect2"> 1391<a name="gst-rtsp-connection-get-ip"></a><h3>gst_rtsp_connection_get_ip ()</h3> 1392<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 1393gst_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> 1394<p>Retrieve the IP address of the other end of <em class="parameter"><code>conn</code></em> 1395.</p> 1396<div class="refsect3"> 1397<a name="gst-rtsp-connection-get-ip.parameters"></a><h4>Parameters</h4> 1398<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1399<colgroup> 1400<col width="150px" class="parameters_name"> 1401<col class="parameters_description"> 1402<col width="200px" class="parameters_annotations"> 1403</colgroup> 1404<tbody><tr> 1405<td class="parameter_name"><p>conn</p></td> 1406<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> 1407<td class="parameter_annotations"> </td> 1408</tr></tbody> 1409</table></div> 1410</div> 1411<div class="refsect3"> 1412<a name="gst-rtsp-connection-get-ip.returns"></a><h4>Returns</h4> 1413<p> The IP address as a string. this value remains valid until the 1414connection is closed.</p> 1415</div> 1416</div> 1417<hr> 1418<div class="refsect2"> 1419<a name="gst-rtsp-connection-get-url"></a><h3>gst_rtsp_connection_get_url ()</h3> 1420<pre class="programlisting"><a class="link" href="GstRTSPUrl.html" title="GstRTSPUrl"><span class="returnvalue">GstRTSPUrl</span></a> * 1421gst_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> 1422<p>Retrieve the URL of the other end of <em class="parameter"><code>conn</code></em> 1423.</p> 1424<div class="refsect3"> 1425<a name="gst-rtsp-connection-get-url.parameters"></a><h4>Parameters</h4> 1426<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1427<colgroup> 1428<col width="150px" class="parameters_name"> 1429<col class="parameters_description"> 1430<col width="200px" class="parameters_annotations"> 1431</colgroup> 1432<tbody><tr> 1433<td class="parameter_name"><p>conn</p></td> 1434<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> 1435<td class="parameter_annotations"> </td> 1436</tr></tbody> 1437</table></div> 1438</div> 1439<div class="refsect3"> 1440<a name="gst-rtsp-connection-get-url.returns"></a><h4>Returns</h4> 1441<p> The URL. This value remains valid until the 1442connection is freed.</p> 1443</div> 1444</div> 1445<hr> 1446<div class="refsect2"> 1447<a name="gst-rtsp-connection-set-tunneled"></a><h3>gst_rtsp_connection_set_tunneled ()</h3> 1448<pre class="programlisting"><span class="returnvalue">void</span> 1449gst_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>, 1450 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> tunneled</code></em>);</pre> 1451<p>Set the HTTP tunneling state of the connection. This must be configured before 1452the <em class="parameter"><code>conn</code></em> 1453 is connected.</p> 1454<div class="refsect3"> 1455<a name="gst-rtsp-connection-set-tunneled.parameters"></a><h4>Parameters</h4> 1456<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1457<colgroup> 1458<col width="150px" class="parameters_name"> 1459<col class="parameters_description"> 1460<col width="200px" class="parameters_annotations"> 1461</colgroup> 1462<tbody> 1463<tr> 1464<td class="parameter_name"><p>conn</p></td> 1465<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> 1466<td class="parameter_annotations"> </td> 1467</tr> 1468<tr> 1469<td class="parameter_name"><p>tunneled</p></td> 1470<td class="parameter_description"><p>the new state</p></td> 1471<td class="parameter_annotations"> </td> 1472</tr> 1473</tbody> 1474</table></div> 1475</div> 1476</div> 1477<hr> 1478<div class="refsect2"> 1479<a name="gst-rtsp-connection-is-tunneled"></a><h3>gst_rtsp_connection_is_tunneled ()</h3> 1480<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 1481gst_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> 1482<p>Get the tunneling state of the connection.</p> 1483<div class="refsect3"> 1484<a name="gst-rtsp-connection-is-tunneled.parameters"></a><h4>Parameters</h4> 1485<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1486<colgroup> 1487<col width="150px" class="parameters_name"> 1488<col class="parameters_description"> 1489<col width="200px" class="parameters_annotations"> 1490</colgroup> 1491<tbody><tr> 1492<td class="parameter_name"><p>conn</p></td> 1493<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> 1494<td class="parameter_annotations"> </td> 1495</tr></tbody> 1496</table></div> 1497</div> 1498<div class="refsect3"> 1499<a name="gst-rtsp-connection-is-tunneled.returns"></a><h4>Returns</h4> 1500<p> if <em class="parameter"><code>conn</code></em> 1501is using HTTP tunneling.</p> 1502</div> 1503</div> 1504<hr> 1505<div class="refsect2"> 1506<a name="gst-rtsp-connection-get-tunnelid"></a><h3>gst_rtsp_connection_get_tunnelid ()</h3> 1507<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 1508gst_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> 1509<p>Get the tunnel session id the connection.</p> 1510<div class="refsect3"> 1511<a name="gst-rtsp-connection-get-tunnelid.parameters"></a><h4>Parameters</h4> 1512<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1513<colgroup> 1514<col width="150px" class="parameters_name"> 1515<col class="parameters_description"> 1516<col width="200px" class="parameters_annotations"> 1517</colgroup> 1518<tbody><tr> 1519<td class="parameter_name"><p>conn</p></td> 1520<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> 1521<td class="parameter_annotations"> </td> 1522</tr></tbody> 1523</table></div> 1524</div> 1525<div class="refsect3"> 1526<a name="gst-rtsp-connection-get-tunnelid.returns"></a><h4>Returns</h4> 1527<p> returns a non-empty string if <em class="parameter"><code>conn</code></em> 1528is being tunneled over HTTP.</p> 1529</div> 1530</div> 1531<hr> 1532<div class="refsect2"> 1533<a name="gst-rtsp-connection-do-tunnel"></a><h3>gst_rtsp_connection_do_tunnel ()</h3> 1534<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1535gst_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>, 1536 <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> 1537<p>If <em class="parameter"><code>conn</code></em> 1538 received the first tunnel connection and <em class="parameter"><code>conn2</code></em> 1539 received 1540the second tunnel connection, link the two connections together so that 1541<em class="parameter"><code>conn</code></em> 1542 manages the tunneled connection.</p> 1543<p>After this call, <em class="parameter"><code>conn2</code></em> 1544 cannot be used anymore and must be freed with 1545<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> 1546<p>If <em class="parameter"><code>conn2</code></em> 1547 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then only the base64 decoding context will be setup for 1548<em class="parameter"><code>conn</code></em> 1549.</p> 1550<div class="refsect3"> 1551<a name="gst-rtsp-connection-do-tunnel.parameters"></a><h4>Parameters</h4> 1552<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1553<colgroup> 1554<col width="150px" class="parameters_name"> 1555<col class="parameters_description"> 1556<col width="200px" class="parameters_annotations"> 1557</colgroup> 1558<tbody> 1559<tr> 1560<td class="parameter_name"><p>conn</p></td> 1561<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> 1562<td class="parameter_annotations"> </td> 1563</tr> 1564<tr> 1565<td class="parameter_name"><p>conn2</p></td> 1566<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="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td> 1567<td class="parameter_annotations"> </td> 1568</tr> 1569</tbody> 1570</table></div> 1571</div> 1572<div class="refsect3"> 1573<a name="gst-rtsp-connection-do-tunnel.returns"></a><h4>Returns</h4> 1574<p> return GST_RTSP_OK on success.</p> 1575</div> 1576</div> 1577<hr> 1578<div class="refsect2"> 1579<a name="gst-rtsp-connection-set-http-mode"></a><h3>gst_rtsp_connection_set_http_mode ()</h3> 1580<pre class="programlisting"><span class="returnvalue">void</span> 1581gst_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>, 1582 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enable</code></em>);</pre> 1583<p>By setting the HTTP mode to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> the message parsing will support HTTP 1584messages in addition to the RTSP messages. It will also disable the 1585automatic handling of setting up an HTTP tunnel.</p> 1586<div class="refsect3"> 1587<a name="gst-rtsp-connection-set-http-mode.parameters"></a><h4>Parameters</h4> 1588<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1589<colgroup> 1590<col width="150px" class="parameters_name"> 1591<col class="parameters_description"> 1592<col width="200px" class="parameters_annotations"> 1593</colgroup> 1594<tbody> 1595<tr> 1596<td class="parameter_name"><p>conn</p></td> 1597<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> 1598<td class="parameter_annotations"> </td> 1599</tr> 1600<tr> 1601<td class="parameter_name"><p>enable</p></td> 1602<td class="parameter_description"><p><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to enable manual HTTP mode</p></td> 1603<td class="parameter_annotations"> </td> 1604</tr> 1605</tbody> 1606</table></div> 1607</div> 1608</div> 1609<hr> 1610<div class="refsect2"> 1611<a name="gst-rtsp-connection-set-proxy"></a><h3>gst_rtsp_connection_set_proxy ()</h3> 1612<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1613gst_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>, 1614 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host</code></em>, 1615 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> port</code></em>);</pre> 1616<p>Set the proxy host and port.</p> 1617<div class="refsect3"> 1618<a name="gst-rtsp-connection-set-proxy.parameters"></a><h4>Parameters</h4> 1619<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1620<colgroup> 1621<col width="150px" class="parameters_name"> 1622<col class="parameters_description"> 1623<col width="200px" class="parameters_annotations"> 1624</colgroup> 1625<tbody> 1626<tr> 1627<td class="parameter_name"><p>conn</p></td> 1628<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> 1629<td class="parameter_annotations"> </td> 1630</tr> 1631<tr> 1632<td class="parameter_name"><p>host</p></td> 1633<td class="parameter_description"><p>the proxy host</p></td> 1634<td class="parameter_annotations"> </td> 1635</tr> 1636<tr> 1637<td class="parameter_name"><p>port</p></td> 1638<td class="parameter_description"><p>the proxy port</p></td> 1639<td class="parameter_annotations"> </td> 1640</tr> 1641</tbody> 1642</table></div> 1643</div> 1644<div class="refsect3"> 1645<a name="gst-rtsp-connection-set-proxy.returns"></a><h4>Returns</h4> 1646<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1647</div> 1648</div> 1649<hr> 1650<div class="refsect2"> 1651<a name="gst-rtsp-connection-get-read-socket"></a><h3>gst_rtsp_connection_get_read_socket ()</h3> 1652<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gio/GSocket.html#GSocket-struct"><span class="returnvalue">GSocket</span></a> * 1653gst_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> 1654<p>Get the file descriptor for reading.</p> 1655<div class="refsect3"> 1656<a name="gst-rtsp-connection-get-read-socket.parameters"></a><h4>Parameters</h4> 1657<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1658<colgroup> 1659<col width="150px" class="parameters_name"> 1660<col class="parameters_description"> 1661<col width="200px" class="parameters_annotations"> 1662</colgroup> 1663<tbody><tr> 1664<td class="parameter_name"><p>conn</p></td> 1665<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> 1666<td class="parameter_annotations"> </td> 1667</tr></tbody> 1668</table></div> 1669</div> 1670<div class="refsect3"> 1671<a name="gst-rtsp-connection-get-read-socket.returns"></a><h4>Returns</h4> 1672<p>the file descriptor used for reading or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on 1673error. The file descriptor remains valid until the connection is closed. </p> 1674<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> 1675</div> 1676</div> 1677<hr> 1678<div class="refsect2"> 1679<a name="gst-rtsp-connection-get-write-socket"></a><h3>gst_rtsp_connection_get_write_socket ()</h3> 1680<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gio/GSocket.html#GSocket-struct"><span class="returnvalue">GSocket</span></a> * 1681gst_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> 1682<p>Get the file descriptor for writing.</p> 1683<div class="refsect3"> 1684<a name="gst-rtsp-connection-get-write-socket.parameters"></a><h4>Parameters</h4> 1685<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1686<colgroup> 1687<col width="150px" class="parameters_name"> 1688<col class="parameters_description"> 1689<col width="200px" class="parameters_annotations"> 1690</colgroup> 1691<tbody><tr> 1692<td class="parameter_name"><p>conn</p></td> 1693<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> 1694<td class="parameter_annotations"> </td> 1695</tr></tbody> 1696</table></div> 1697</div> 1698<div class="refsect3"> 1699<a name="gst-rtsp-connection-get-write-socket.returns"></a><h4>Returns</h4> 1700<p>the file descriptor used for writing or NULL on 1701error. The file descriptor remains valid until the connection is closed. </p> 1702<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> 1703</div> 1704</div> 1705<hr> 1706<div class="refsect2"> 1707<a name="gst-rtsp-connection-get-tls"></a><h3>gst_rtsp_connection_get_tls ()</h3> 1708<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gio/GTlsConnection.html#GTlsConnection-struct"><span class="returnvalue">GTlsConnection</span></a> * 1709gst_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>, 1710 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> 1711<p>Get the TLS connection of <em class="parameter"><code>conn</code></em> 1712.</p> 1713<p>For client side this will return the <a href="/usr/share/gtk-doc/html/gio/GTlsClientConnection.html#GTlsClientConnection-struct"><span class="type">GTlsClientConnection</span></a> when connected 1714over TLS.</p> 1715<p>For server side connections, this function will create a GTlsServerConnection 1716when called the first time and will return that same connection on subsequent 1717calls. The server is then responsible for configuring the TLS connection.</p> 1718<div class="refsect3"> 1719<a name="gst-rtsp-connection-get-tls.parameters"></a><h4>Parameters</h4> 1720<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1721<colgroup> 1722<col width="150px" class="parameters_name"> 1723<col class="parameters_description"> 1724<col width="200px" class="parameters_annotations"> 1725</colgroup> 1726<tbody> 1727<tr> 1728<td class="parameter_name"><p>conn</p></td> 1729<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> 1730<td class="parameter_annotations"> </td> 1731</tr> 1732<tr> 1733<td class="parameter_name"><p>error</p></td> 1734<td class="parameter_description"><p><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or NULL to ignore.</p></td> 1735<td class="parameter_annotations"> </td> 1736</tr> 1737</tbody> 1738</table></div> 1739</div> 1740<div class="refsect3"> 1741<a name="gst-rtsp-connection-get-tls.returns"></a><h4>Returns</h4> 1742<p>the TLS connection for <em class="parameter"><code>conn</code></em> 1743. </p> 1744<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> 1745</div> 1746<p class="since">Since: <a class="link" href="ix14.html#api-index-1.2">1.2</a></p> 1747</div> 1748<hr> 1749<div class="refsect2"> 1750<a name="gst-rtsp-connection-set-tls-validation-flags"></a><h3>gst_rtsp_connection_set_tls_validation_flags ()</h3> 1751<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 1752gst_rtsp_connection_set_tls_validation_flags 1753 (<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>, 1754 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> flags</code></em>);</pre> 1755<p>Sets the TLS validation flags to be used to verify the peer 1756certificate when a TLS connection is established.</p> 1757<div class="refsect3"> 1758<a name="gst-rtsp-connection-set-tls-validation-flags.parameters"></a><h4>Parameters</h4> 1759<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1760<colgroup> 1761<col width="150px" class="parameters_name"> 1762<col class="parameters_description"> 1763<col width="200px" class="parameters_annotations"> 1764</colgroup> 1765<tbody> 1766<tr> 1767<td class="parameter_name"><p>conn</p></td> 1768<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> 1769<td class="parameter_annotations"> </td> 1770</tr> 1771<tr> 1772<td class="parameter_name"><p>flags</p></td> 1773<td class="parameter_description"><p>the validation flags.</p></td> 1774<td class="parameter_annotations"> </td> 1775</tr> 1776</tbody> 1777</table></div> 1778</div> 1779<div class="refsect3"> 1780<a name="gst-rtsp-connection-set-tls-validation-flags.returns"></a><h4>Returns</h4> 1781<p> TRUE if the validation flags are set correctly, or FALSE if 1782<em class="parameter"><code>conn</code></em> 1783is NULL or is not a TLS connection.</p> 1784</div> 1785<p class="since">Since: <a class="link" href="ix13.html#api-index-1.2.1">1.2.1</a></p> 1786</div> 1787<hr> 1788<div class="refsect2"> 1789<a name="gst-rtsp-connection-get-tls-validation-flags"></a><h3>gst_rtsp_connection_get_tls_validation_flags ()</h3> 1790<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a> 1791gst_rtsp_connection_get_tls_validation_flags 1792 (<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> 1793<p>Gets the TLS validation flags used to verify the peer certificate 1794when a TLS connection is established.</p> 1795<div class="refsect3"> 1796<a name="gst-rtsp-connection-get-tls-validation-flags.parameters"></a><h4>Parameters</h4> 1797<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1798<colgroup> 1799<col width="150px" class="parameters_name"> 1800<col class="parameters_description"> 1801<col width="200px" class="parameters_annotations"> 1802</colgroup> 1803<tbody><tr> 1804<td class="parameter_name"><p>conn</p></td> 1805<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> 1806<td class="parameter_annotations"> </td> 1807</tr></tbody> 1808</table></div> 1809</div> 1810<div class="refsect3"> 1811<a name="gst-rtsp-connection-get-tls-validation-flags.returns"></a><h4>Returns</h4> 1812<p> the validationg flags.</p> 1813</div> 1814<p class="since">Since: <a class="link" href="ix13.html#api-index-1.2.1">1.2.1</a></p> 1815</div> 1816<hr> 1817<div class="refsect2"> 1818<a name="gst-rtsp-connection-set-tls-database"></a><h3>gst_rtsp_connection_set_tls_database ()</h3> 1819<pre class="programlisting"><span class="returnvalue">void</span> 1820gst_rtsp_connection_set_tls_database (<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>, 1821 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GTlsDatabase.html#GTlsDatabase-struct"><span class="type">GTlsDatabase</span></a> *database</code></em>);</pre> 1822<p>Sets the anchor certificate authorities database. This certificate 1823database will be used to verify the server's certificate in case it 1824can't be verified with the default certificate database first.</p> 1825<div class="refsect3"> 1826<a name="gst-rtsp-connection-set-tls-database.parameters"></a><h4>Parameters</h4> 1827<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1828<colgroup> 1829<col width="150px" class="parameters_name"> 1830<col class="parameters_description"> 1831<col width="200px" class="parameters_annotations"> 1832</colgroup> 1833<tbody> 1834<tr> 1835<td class="parameter_name"><p>conn</p></td> 1836<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> 1837<td class="parameter_annotations"> </td> 1838</tr> 1839<tr> 1840<td class="parameter_name"><p>database</p></td> 1841<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gio/GTlsDatabase.html#GTlsDatabase-struct"><span class="type">GTlsDatabase</span></a></p></td> 1842<td class="parameter_annotations"> </td> 1843</tr> 1844</tbody> 1845</table></div> 1846</div> 1847<p class="since">Since: <a class="link" href="ix11.html#api-index-1.4">1.4</a></p> 1848</div> 1849<hr> 1850<div class="refsect2"> 1851<a name="gst-rtsp-connection-get-tls-database"></a><h3>gst_rtsp_connection_get_tls_database ()</h3> 1852<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gio/GTlsDatabase.html#GTlsDatabase-struct"><span class="returnvalue">GTlsDatabase</span></a> * 1853gst_rtsp_connection_get_tls_database (<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> 1854<p>Gets the anchor certificate authorities database that will be used 1855after a server certificate can't be verified with the default 1856certificate database.</p> 1857<div class="refsect3"> 1858<a name="gst-rtsp-connection-get-tls-database.parameters"></a><h4>Parameters</h4> 1859<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1860<colgroup> 1861<col width="150px" class="parameters_name"> 1862<col class="parameters_description"> 1863<col width="200px" class="parameters_annotations"> 1864</colgroup> 1865<tbody><tr> 1866<td class="parameter_name"><p>conn</p></td> 1867<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> 1868<td class="parameter_annotations"> </td> 1869</tr></tbody> 1870</table></div> 1871</div> 1872<div class="refsect3"> 1873<a name="gst-rtsp-connection-get-tls-database.returns"></a><h4>Returns</h4> 1874<p>the anchor certificate authorities database, or NULL if no 1875database has been previously set. Use <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release the 1876certificate database. </p> 1877<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 1878</div> 1879<p class="since">Since: <a class="link" href="ix11.html#api-index-1.4">1.4</a></p> 1880</div> 1881<hr> 1882<div class="refsect2"> 1883<a name="gst-rtsp-connection-set-tls-interaction"></a><h3>gst_rtsp_connection_set_tls_interaction ()</h3> 1884<pre class="programlisting"><span class="returnvalue">void</span> 1885gst_rtsp_connection_set_tls_interaction 1886 (<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>, 1887 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GTlsInteraction.html#GTlsInteraction-struct"><span class="type">GTlsInteraction</span></a> *interaction</code></em>);</pre> 1888<p>Sets a <a href="/usr/share/gtk-doc/html/gio/GTlsInteraction.html#GTlsInteraction-struct"><span class="type">GTlsInteraction</span></a> object to be used when the connection or certificate 1889database need to interact with the user. This will be used to prompt the 1890user for passwords where necessary.</p> 1891<div class="refsect3"> 1892<a name="gst-rtsp-connection-set-tls-interaction.parameters"></a><h4>Parameters</h4> 1893<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1894<colgroup> 1895<col width="150px" class="parameters_name"> 1896<col class="parameters_description"> 1897<col width="200px" class="parameters_annotations"> 1898</colgroup> 1899<tbody> 1900<tr> 1901<td class="parameter_name"><p>conn</p></td> 1902<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> 1903<td class="parameter_annotations"> </td> 1904</tr> 1905<tr> 1906<td class="parameter_name"><p>interaction</p></td> 1907<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gio/GTlsInteraction.html#GTlsInteraction-struct"><span class="type">GTlsInteraction</span></a></p></td> 1908<td class="parameter_annotations"> </td> 1909</tr> 1910</tbody> 1911</table></div> 1912</div> 1913<p class="since">Since: <a class="link" href="ix10.html#api-index-1.6">1.6</a></p> 1914</div> 1915<hr> 1916<div class="refsect2"> 1917<a name="gst-rtsp-connection-get-tls-interaction"></a><h3>gst_rtsp_connection_get_tls_interaction ()</h3> 1918<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gio/GTlsInteraction.html#GTlsInteraction-struct"><span class="returnvalue">GTlsInteraction</span></a> * 1919gst_rtsp_connection_get_tls_interaction 1920 (<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> 1921<p>Gets a <a href="/usr/share/gtk-doc/html/gio/GTlsInteraction.html#GTlsInteraction-struct"><span class="type">GTlsInteraction</span></a> object to be used when the connection or certificate 1922database need to interact with the user. This will be used to prompt the 1923user for passwords where necessary.</p> 1924<div class="refsect3"> 1925<a name="gst-rtsp-connection-get-tls-interaction.parameters"></a><h4>Parameters</h4> 1926<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1927<colgroup> 1928<col width="150px" class="parameters_name"> 1929<col class="parameters_description"> 1930<col width="200px" class="parameters_annotations"> 1931</colgroup> 1932<tbody><tr> 1933<td class="parameter_name"><p>conn</p></td> 1934<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> 1935<td class="parameter_annotations"> </td> 1936</tr></tbody> 1937</table></div> 1938</div> 1939<div class="refsect3"> 1940<a name="gst-rtsp-connection-get-tls-interaction.returns"></a><h4>Returns</h4> 1941<p>a reference on the <a href="/usr/share/gtk-doc/html/gio/GTlsInteraction.html#GTlsInteraction-struct"><span class="type">GTlsInteraction</span></a>. Use 1942<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release. </p> 1943<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 1944</div> 1945<p class="since">Since: <a class="link" href="ix10.html#api-index-1.6">1.6</a></p> 1946</div> 1947<hr> 1948<div class="refsect2"> 1949<a name="gst-rtsp-connection-get-remember-session-id"></a><h3>gst_rtsp_connection_get_remember_session_id ()</h3> 1950<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 1951gst_rtsp_connection_get_remember_session_id 1952 (<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> 1953<div class="refsect3"> 1954<a name="gst-rtsp-connection-get-remember-session-id.parameters"></a><h4>Parameters</h4> 1955<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1956<colgroup> 1957<col width="150px" class="parameters_name"> 1958<col class="parameters_description"> 1959<col width="200px" class="parameters_annotations"> 1960</colgroup> 1961<tbody><tr> 1962<td class="parameter_name"><p>conn</p></td> 1963<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> 1964<td class="parameter_annotations"> </td> 1965</tr></tbody> 1966</table></div> 1967</div> 1968<div class="refsect3"> 1969<a name="gst-rtsp-connection-get-remember-session-id.returns"></a><h4>Returns</h4> 1970<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> remembers the session id in the 1971last response to set it on any further request.</p> 1972</div> 1973</div> 1974<hr> 1975<div class="refsect2"> 1976<a name="gst-rtsp-connection-set-remember-session-id"></a><h3>gst_rtsp_connection_set_remember_session_id ()</h3> 1977<pre class="programlisting"><span class="returnvalue">void</span> 1978gst_rtsp_connection_set_remember_session_id 1979 (<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>, 1980 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> remember</code></em>);</pre> 1981<p>Sets if the <a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> should remember the session id from the last 1982response received and force it onto any further requests.</p> 1983<p>The default value is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a></p> 1984<div class="refsect3"> 1985<a name="gst-rtsp-connection-set-remember-session-id.parameters"></a><h4>Parameters</h4> 1986<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1987<colgroup> 1988<col width="150px" class="parameters_name"> 1989<col class="parameters_description"> 1990<col width="200px" class="parameters_annotations"> 1991</colgroup> 1992<tbody> 1993<tr> 1994<td class="parameter_name"><p>conn</p></td> 1995<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> 1996<td class="parameter_annotations"> </td> 1997</tr> 1998<tr> 1999<td class="parameter_name"><p>remember</p></td> 2000<td class="parameter_description"><p><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the connection should remember the session id</p></td> 2001<td class="parameter_annotations"> </td> 2002</tr> 2003</tbody> 2004</table></div> 2005</div> 2006</div> 2007<hr> 2008<div class="refsect2"> 2009<a name="GstRTSPConnectionAcceptCertificateFunc"></a><h3>GstRTSPConnectionAcceptCertificateFunc ()</h3> 2010<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 2011<span class="c_punctuation">(</span>*GstRTSPConnectionAcceptCertificateFunc<span class="c_punctuation">)</span> 2012 (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GTlsConnection.html#GTlsConnection-struct"><span class="type">GTlsConnection</span></a> *conn</code></em>, 2013 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/GTlsCertificate.html#GTlsCertificate-struct"><span class="type">GTlsCertificate</span></a> *peer_cert</code></em>, 2014 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a> errors</code></em>, 2015 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> 2016</div> 2017<hr> 2018<div class="refsect2"> 2019<a name="gst-rtsp-connection-set-accept-certificate-func"></a><h3>gst_rtsp_connection_set_accept_certificate_func ()</h3> 2020<pre class="programlisting"><span class="returnvalue">void</span> 2021gst_rtsp_connection_set_accept_certificate_func 2022 (<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>, 2023 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPConnectionAcceptCertificateFunc" title="GstRTSPConnectionAcceptCertificateFunc ()"><span class="type">GstRTSPConnectionAcceptCertificateFunc</span></a> func</code></em>, 2024 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, 2025 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy_notify</code></em>);</pre> 2026<p>Sets a custom accept-certificate function for checking certificates for 2027validity. This will directly map to <a href="/usr/share/gtk-doc/html/gio/GTlsConnection.html#GTlsConnection-struct"><span class="type">GTlsConnection</span></a> 's "accept-certificate" 2028signal and be performed after the default checks of <a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPConnection" title="GstRTSPConnection"><span class="type">GstRTSPConnection</span></a> 2029(checking against the <a href="/usr/share/gtk-doc/html/gio/GTlsDatabase.html#GTlsDatabase-struct"><span class="type">GTlsDatabase</span></a> with the given <a href="/usr/share/gtk-doc/html/gio/gio-TLS-Overview.html#GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a>) 2030have failed. If no <a href="/usr/share/gtk-doc/html/gio/GTlsDatabase.html#GTlsDatabase-struct"><span class="type">GTlsDatabase</span></a> is set on this connection, only <em class="parameter"><code>func</code></em> 2031 will 2032be called.</p> 2033<div class="refsect3"> 2034<a name="gst-rtsp-connection-set-accept-certificate-func.parameters"></a><h4>Parameters</h4> 2035<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2036<colgroup> 2037<col width="150px" class="parameters_name"> 2038<col class="parameters_description"> 2039<col width="200px" class="parameters_annotations"> 2040</colgroup> 2041<tbody> 2042<tr> 2043<td class="parameter_name"><p>conn</p></td> 2044<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> 2045<td class="parameter_annotations"> </td> 2046</tr> 2047<tr> 2048<td class="parameter_name"><p>func</p></td> 2049<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPConnectionAcceptCertificateFunc" title="GstRTSPConnectionAcceptCertificateFunc ()"><span class="type">GstRTSPConnectionAcceptCertificateFunc</span></a> to check certificates</p></td> 2050<td class="parameter_annotations"> </td> 2051</tr> 2052<tr> 2053<td class="parameter_name"><p>destroy_notify</p></td> 2054<td class="parameter_description"><p><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> for <em class="parameter"><code>user_data</code></em> 2055</p></td> 2056<td class="parameter_annotations"> </td> 2057</tr> 2058<tr> 2059<td class="parameter_name"><p>user_data</p></td> 2060<td class="parameter_description"><p>User data passed to <em class="parameter"><code>func</code></em> 2061</p></td> 2062<td class="parameter_annotations"> </td> 2063</tr> 2064</tbody> 2065</table></div> 2066</div> 2067<p class="since">Since: <a class="link" href="ix04.html#api-index-1.14">1.14</a></p> 2068</div> 2069<hr> 2070<div class="refsect2"> 2071<a name="gst-rtsp-watch-new"></a><h3>gst_rtsp_watch_new ()</h3> 2072<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="returnvalue">GstRTSPWatch</span></a> * 2073gst_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>, 2074 <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>, 2075 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>, 2076 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);</pre> 2077<p>Create a watch object for <em class="parameter"><code>conn</code></em> 2078. The functions provided in <em class="parameter"><code>funcs</code></em> 2079 will be 2080called with <em class="parameter"><code>user_data</code></em> 2081 when activity happened on the watch.</p> 2082<p>The new watch is usually created so that it can be attached to a 2083maincontext 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> 2084<p><em class="parameter"><code>conn</code></em> 2085 must exist for the entire lifetime of the watch.</p> 2086<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p> 2087<div class="refsect3"> 2088<a name="gst-rtsp-watch-new.parameters"></a><h4>Parameters</h4> 2089<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2090<colgroup> 2091<col width="150px" class="parameters_name"> 2092<col class="parameters_description"> 2093<col width="200px" class="parameters_annotations"> 2094</colgroup> 2095<tbody> 2096<tr> 2097<td class="parameter_name"><p>conn</p></td> 2098<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> 2099<td class="parameter_annotations"> </td> 2100</tr> 2101<tr> 2102<td class="parameter_name"><p>funcs</p></td> 2103<td class="parameter_description"><p>watch functions</p></td> 2104<td class="parameter_annotations"> </td> 2105</tr> 2106<tr> 2107<td class="parameter_name"><p>user_data</p></td> 2108<td class="parameter_description"><p>user data to pass to <em class="parameter"><code>funcs</code></em> 2109</p></td> 2110<td class="parameter_annotations"> </td> 2111</tr> 2112<tr> 2113<td class="parameter_name"><p>notify</p></td> 2114<td class="parameter_description"><p>notify when <em class="parameter"><code>user_data</code></em> 2115is not referenced anymore</p></td> 2116<td class="parameter_annotations"> </td> 2117</tr> 2118</tbody> 2119</table></div> 2120</div> 2121<div class="refsect3"> 2122<a name="gst-rtsp-watch-new.returns"></a><h4>Returns</h4> 2123<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 2124communication. 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> 2125</div> 2126</div> 2127<hr> 2128<div class="refsect2"> 2129<a name="gst-rtsp-watch-unref"></a><h3>gst_rtsp_watch_unref ()</h3> 2130<pre class="programlisting"><span class="returnvalue">void</span> 2131gst_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> 2132<p>Decreases the reference count of <em class="parameter"><code>watch</code></em> 2133 by one. If the resulting reference 2134count is zero the watch and associated memory will be destroyed.</p> 2135<div class="refsect3"> 2136<a name="gst-rtsp-watch-unref.parameters"></a><h4>Parameters</h4> 2137<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2138<colgroup> 2139<col width="150px" class="parameters_name"> 2140<col class="parameters_description"> 2141<col width="200px" class="parameters_annotations"> 2142</colgroup> 2143<tbody><tr> 2144<td class="parameter_name"><p>watch</p></td> 2145<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> 2146<td class="parameter_annotations"> </td> 2147</tr></tbody> 2148</table></div> 2149</div> 2150</div> 2151<hr> 2152<div class="refsect2"> 2153<a name="gst-rtsp-watch-attach"></a><h3>gst_rtsp_watch_attach ()</h3> 2154<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> 2155gst_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>, 2156 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *context</code></em>);</pre> 2157<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> 2158<div class="refsect3"> 2159<a name="gst-rtsp-watch-attach.parameters"></a><h4>Parameters</h4> 2160<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2161<colgroup> 2162<col width="150px" class="parameters_name"> 2163<col class="parameters_description"> 2164<col width="200px" class="parameters_annotations"> 2165</colgroup> 2166<tbody> 2167<tr> 2168<td class="parameter_name"><p>watch</p></td> 2169<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> 2170<td class="parameter_annotations"> </td> 2171</tr> 2172<tr> 2173<td class="parameter_name"><p>context</p></td> 2174<td class="parameter_description"><p>a GMainContext (if NULL, the default context will be used)</p></td> 2175<td class="parameter_annotations"> </td> 2176</tr> 2177</tbody> 2178</table></div> 2179</div> 2180<div class="refsect3"> 2181<a name="gst-rtsp-watch-attach.returns"></a><h4>Returns</h4> 2182<p> the ID (greater than 0) for the watch within the GMainContext.</p> 2183</div> 2184</div> 2185<hr> 2186<div class="refsect2"> 2187<a name="gst-rtsp-watch-reset"></a><h3>gst_rtsp_watch_reset ()</h3> 2188<pre class="programlisting"><span class="returnvalue">void</span> 2189gst_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> 2190<p>Reset <em class="parameter"><code>watch</code></em> 2191, 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> 2192when the file descriptors of the connection might have changed.</p> 2193<div class="refsect3"> 2194<a name="gst-rtsp-watch-reset.parameters"></a><h4>Parameters</h4> 2195<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2196<colgroup> 2197<col width="150px" class="parameters_name"> 2198<col class="parameters_description"> 2199<col width="200px" class="parameters_annotations"> 2200</colgroup> 2201<tbody><tr> 2202<td class="parameter_name"><p>watch</p></td> 2203<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> 2204<td class="parameter_annotations"> </td> 2205</tr></tbody> 2206</table></div> 2207</div> 2208</div> 2209<hr> 2210<div class="refsect2"> 2211<a name="gst-rtsp-watch-send-message"></a><h3>gst_rtsp_watch_send_message ()</h3> 2212<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 2213gst_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>, 2214 <em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *message</code></em>, 2215 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *id</code></em>);</pre> 2216<p>Send a <em class="parameter"><code>message</code></em> 2217 using the connection of the <em class="parameter"><code>watch</code></em> 2218. If it cannot be sent 2219immediately, it will be queued for transmission in <em class="parameter"><code>watch</code></em> 2220. The contents of 2221<em class="parameter"><code>message</code></em> 2222 will then be serialized and transmitted when the connection of the 2223<em class="parameter"><code>watch</code></em> 2224 becomes writable. In case the <em class="parameter"><code>message</code></em> 2225 is queued, the ID returned in 2226<em class="parameter"><code>id</code></em> 2227 will be non-zero and used as the ID argument in the message_sent 2228callback.</p> 2229<div class="refsect3"> 2230<a name="gst-rtsp-watch-send-message.parameters"></a><h4>Parameters</h4> 2231<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2232<colgroup> 2233<col width="150px" class="parameters_name"> 2234<col class="parameters_description"> 2235<col width="200px" class="parameters_annotations"> 2236</colgroup> 2237<tbody> 2238<tr> 2239<td class="parameter_name"><p>watch</p></td> 2240<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> 2241<td class="parameter_annotations"> </td> 2242</tr> 2243<tr> 2244<td class="parameter_name"><p>message</p></td> 2245<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 2246<td class="parameter_annotations"> </td> 2247</tr> 2248<tr> 2249<td class="parameter_name"><p>id</p></td> 2250<td class="parameter_description"><p>location for a message ID or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 2251<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> 2252</tr> 2253</tbody> 2254</table></div> 2255</div> 2256<div class="refsect3"> 2257<a name="gst-rtsp-watch-send-message.returns"></a><h4>Returns</h4> 2258<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> 2259</div> 2260</div> 2261<hr> 2262<div class="refsect2"> 2263<a name="gst-rtsp-watch-send-messages"></a><h3>gst_rtsp_watch_send_messages ()</h3> 2264<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 2265gst_rtsp_watch_send_messages (<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>, 2266 <em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *messages</code></em>, 2267 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_messages</code></em>, 2268 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *id</code></em>);</pre> 2269<p>Sends <em class="parameter"><code>messages</code></em> 2270 using the connection of the <em class="parameter"><code>watch</code></em> 2271. If they cannot be sent 2272immediately, they will be queued for transmission in <em class="parameter"><code>watch</code></em> 2273. The contents of 2274<em class="parameter"><code>messages</code></em> 2275 will then be serialized and transmitted when the connection of the 2276<em class="parameter"><code>watch</code></em> 2277 becomes writable. In case the <em class="parameter"><code>messages</code></em> 2278 are queued, the ID returned in 2279<em class="parameter"><code>id</code></em> 2280 will be non-zero and used as the ID argument in the message_sent 2281callback once the last message is sent. The callback will only be called 2282once for the last message.</p> 2283<div class="refsect3"> 2284<a name="gst-rtsp-watch-send-messages.parameters"></a><h4>Parameters</h4> 2285<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2286<colgroup> 2287<col width="150px" class="parameters_name"> 2288<col class="parameters_description"> 2289<col width="200px" class="parameters_annotations"> 2290</colgroup> 2291<tbody> 2292<tr> 2293<td class="parameter_name"><p>watch</p></td> 2294<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> 2295<td class="parameter_annotations"> </td> 2296</tr> 2297<tr> 2298<td class="parameter_name"><p>messages</p></td> 2299<td class="parameter_description"><p>the messages to send. </p></td> 2300<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_messages]</span></td> 2301</tr> 2302<tr> 2303<td class="parameter_name"><p>n_messages</p></td> 2304<td class="parameter_description"><p>the number of messages to send</p></td> 2305<td class="parameter_annotations"> </td> 2306</tr> 2307<tr> 2308<td class="parameter_name"><p>id</p></td> 2309<td class="parameter_description"><p>location for a message ID or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 2310<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> 2311</tr> 2312</tbody> 2313</table></div> 2314</div> 2315<div class="refsect3"> 2316<a name="gst-rtsp-watch-send-messages.returns"></a><h4>Returns</h4> 2317<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> 2318</div> 2319<p class="since">Since: <a class="link" href="ix03.html#api-index-1.16">1.16</a></p> 2320</div> 2321<hr> 2322<div class="refsect2"> 2323<a name="gst-rtsp-watch-write-data"></a><h3>gst_rtsp_watch_write_data ()</h3> 2324<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 2325gst_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>, 2326 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *data</code></em>, 2327 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>, 2328 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *id</code></em>);</pre> 2329<p>Write <em class="parameter"><code>data</code></em> 2330 using the connection of the <em class="parameter"><code>watch</code></em> 2331. If it cannot be sent 2332immediately, it will be queued for transmission in <em class="parameter"><code>watch</code></em> 2333. The contents of 2334<em class="parameter"><code>message</code></em> 2335 will then be serialized and transmitted when the connection of the 2336<em class="parameter"><code>watch</code></em> 2337 becomes writable. In case the <em class="parameter"><code>message</code></em> 2338 is queued, the ID returned in 2339<em class="parameter"><code>id</code></em> 2340 will be non-zero and used as the ID argument in the message_sent 2341callback.</p> 2342<p>This function will take ownership of <em class="parameter"><code>data</code></em> 2343 and <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> it after use.</p> 2344<p>If the amount of queued data exceeds the limits set with 2345<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 2346<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-ENOMEM:CAPS"><span class="type">GST_RTSP_ENOMEM</span></a>.</p> 2347<div class="refsect3"> 2348<a name="gst-rtsp-watch-write-data.parameters"></a><h4>Parameters</h4> 2349<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2350<colgroup> 2351<col width="150px" class="parameters_name"> 2352<col class="parameters_description"> 2353<col width="200px" class="parameters_annotations"> 2354</colgroup> 2355<tbody> 2356<tr> 2357<td class="parameter_name"><p>watch</p></td> 2358<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> 2359<td class="parameter_annotations"> </td> 2360</tr> 2361<tr> 2362<td class="parameter_name"><p>data</p></td> 2363<td class="parameter_description"><p>the data to queue. </p></td> 2364<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> 2365</tr> 2366<tr> 2367<td class="parameter_name"><p>size</p></td> 2368<td class="parameter_description"><p>the size of <em class="parameter"><code>data</code></em> 2369</p></td> 2370<td class="parameter_annotations"> </td> 2371</tr> 2372<tr> 2373<td class="parameter_name"><p>id</p></td> 2374<td class="parameter_description"><p>location for a message ID or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 2375<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> 2376</tr> 2377</tbody> 2378</table></div> 2379</div> 2380<div class="refsect3"> 2381<a name="gst-rtsp-watch-write-data.returns"></a><h4>Returns</h4> 2382<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 2383are reached. <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-EINTR:CAPS"><span class="type">GST_RTSP_EINTR</span></a> when <em class="parameter"><code>watch</code></em> 2384was flushing.</p> 2385</div> 2386</div> 2387<hr> 2388<div class="refsect2"> 2389<a name="gst-rtsp-watch-get-send-backlog"></a><h3>gst_rtsp_watch_get_send_backlog ()</h3> 2390<pre class="programlisting"><span class="returnvalue">void</span> 2391gst_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>, 2392 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *bytes</code></em>, 2393 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *messages</code></em>);</pre> 2394<p>Get the maximum amount of bytes and messages that will be queued in <em class="parameter"><code>watch</code></em> 2395. 2396See <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> 2397<div class="refsect3"> 2398<a name="gst-rtsp-watch-get-send-backlog.parameters"></a><h4>Parameters</h4> 2399<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2400<colgroup> 2401<col width="150px" class="parameters_name"> 2402<col class="parameters_description"> 2403<col width="200px" class="parameters_annotations"> 2404</colgroup> 2405<tbody> 2406<tr> 2407<td class="parameter_name"><p>watch</p></td> 2408<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> 2409<td class="parameter_annotations"> </td> 2410</tr> 2411<tr> 2412<td class="parameter_name"><p>bytes</p></td> 2413<td class="parameter_description"><p>maximum bytes. </p></td> 2414<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> 2415</tr> 2416<tr> 2417<td class="parameter_name"><p>messages</p></td> 2418<td class="parameter_description"><p>maximum messages. </p></td> 2419<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> 2420</tr> 2421</tbody> 2422</table></div> 2423</div> 2424<p class="since">Since: <a class="link" href="ix14.html#api-index-1.2">1.2</a></p> 2425</div> 2426<hr> 2427<div class="refsect2"> 2428<a name="gst-rtsp-watch-set-send-backlog"></a><h3>gst_rtsp_watch_set_send_backlog ()</h3> 2429<pre class="programlisting"><span class="returnvalue">void</span> 2430gst_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>, 2431 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> bytes</code></em>, 2432 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> messages</code></em>);</pre> 2433<p>Set the maximum amount of bytes and messages that will be queued in <em class="parameter"><code>watch</code></em> 2434. 2435When 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 2436<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> 2437<p>A value of 0 for <em class="parameter"><code>bytes</code></em> 2438 or <em class="parameter"><code>messages</code></em> 2439 means no limits.</p> 2440<div class="refsect3"> 2441<a name="gst-rtsp-watch-set-send-backlog.parameters"></a><h4>Parameters</h4> 2442<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2443<colgroup> 2444<col width="150px" class="parameters_name"> 2445<col class="parameters_description"> 2446<col width="200px" class="parameters_annotations"> 2447</colgroup> 2448<tbody> 2449<tr> 2450<td class="parameter_name"><p>watch</p></td> 2451<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> 2452<td class="parameter_annotations"> </td> 2453</tr> 2454<tr> 2455<td class="parameter_name"><p>bytes</p></td> 2456<td class="parameter_description"><p>maximum bytes</p></td> 2457<td class="parameter_annotations"> </td> 2458</tr> 2459<tr> 2460<td class="parameter_name"><p>messages</p></td> 2461<td class="parameter_description"><p>maximum messages</p></td> 2462<td class="parameter_annotations"> </td> 2463</tr> 2464</tbody> 2465</table></div> 2466</div> 2467<p class="since">Since: <a class="link" href="ix14.html#api-index-1.2">1.2</a></p> 2468</div> 2469<hr> 2470<div class="refsect2"> 2471<a name="gst-rtsp-watch-set-flushing"></a><h3>gst_rtsp_watch_set_flushing ()</h3> 2472<pre class="programlisting"><span class="returnvalue">void</span> 2473gst_rtsp_watch_set_flushing (<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>, 2474 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> flushing</code></em>);</pre> 2475<p>When <em class="parameter"><code>flushing</code></em> 2476 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, abort a call to <a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#gst-rtsp-watch-wait-backlog" title="gst_rtsp_watch_wait_backlog ()"><code class="function">gst_rtsp_watch_wait_backlog()</code></a> 2477and make sure <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> returns immediately with 2478<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-EINTR:CAPS"><span class="type">GST_RTSP_EINTR</span></a>. And empty the queue.</p> 2479<div class="refsect3"> 2480<a name="gst-rtsp-watch-set-flushing.parameters"></a><h4>Parameters</h4> 2481<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2482<colgroup> 2483<col width="150px" class="parameters_name"> 2484<col class="parameters_description"> 2485<col width="200px" class="parameters_annotations"> 2486</colgroup> 2487<tbody> 2488<tr> 2489<td class="parameter_name"><p>watch</p></td> 2490<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> 2491<td class="parameter_annotations"> </td> 2492</tr> 2493<tr> 2494<td class="parameter_name"><p>flushing</p></td> 2495<td class="parameter_description"><p>new flushing state</p></td> 2496<td class="parameter_annotations"> </td> 2497</tr> 2498</tbody> 2499</table></div> 2500</div> 2501<p class="since">Since: <a class="link" href="ix11.html#api-index-1.4">1.4</a></p> 2502</div> 2503<hr> 2504<div class="refsect2"> 2505<a name="gst-rtsp-watch-wait-backlog"></a><h3>gst_rtsp_watch_wait_backlog ()</h3> 2506<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 2507gst_rtsp_watch_wait_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>, 2508 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *timeout</code></em>);</pre> 2509<p>Wait until there is place in the backlog queue, <em class="parameter"><code>timeout</code></em> 2510 is reached 2511or <em class="parameter"><code>watch</code></em> 2512 is set to flushing.</p> 2513<p>If <em class="parameter"><code>timeout</code></em> 2514 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> this function can block forever. If <em class="parameter"><code>timeout</code></em> 2515 2516contains a valid timeout, this function will return <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-ETIMEOUT:CAPS"><code class="literal">GST_RTSP_ETIMEOUT</code></a> 2517after the timeout expired.</p> 2518<p>The typically use of this function is when gst_rtsp_watch_write_data 2519returns <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-ENOMEM:CAPS"><code class="literal">GST_RTSP_ENOMEM</code></a>. The caller then calls this function to wait for 2520free space in the backlog queue and try again.</p> 2521<div class="refsect3"> 2522<a name="gst-rtsp-watch-wait-backlog.parameters"></a><h4>Parameters</h4> 2523<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2524<colgroup> 2525<col width="150px" class="parameters_name"> 2526<col class="parameters_description"> 2527<col width="200px" class="parameters_annotations"> 2528</colgroup> 2529<tbody> 2530<tr> 2531<td class="parameter_name"><p>watch</p></td> 2532<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> 2533<td class="parameter_annotations"> </td> 2534</tr> 2535<tr> 2536<td class="parameter_name"><p>timeout</p></td> 2537<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> timeout</p></td> 2538<td class="parameter_annotations"> </td> 2539</tr> 2540</tbody> 2541</table></div> 2542</div> 2543<div class="refsect3"> 2544<a name="gst-rtsp-watch-wait-backlog.returns"></a><h4>Returns</h4> 2545<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><code class="literal">GST_RTSP_OK</code></a> when if there is room in queue. 2546<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-ETIMEOUT:CAPS"><code class="literal">GST_RTSP_ETIMEOUT</code></a> when <em class="parameter"><code>timeout</code></em> 2547was reached. 2548<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-EINTR:CAPS"><code class="literal">GST_RTSP_EINTR</code></a> when <em class="parameter"><code>watch</code></em> 2549is flushing 2550<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-EINVAL:CAPS"><code class="literal">GST_RTSP_EINVAL</code></a> when called with invalid parameters.</p> 2551</div> 2552<p class="since">Since: <a class="link" href="ix11.html#api-index-1.4">1.4</a></p> 2553</div> 2554</div> 2555<div class="refsect1"> 2556<a name="gst-plugins-base-libs-GstRTSPConnection.other_details"></a><h2>Types and Values</h2> 2557<div class="refsect2"> 2558<a name="GstRTSPConnection"></a><h3>GstRTSPConnection</h3> 2559<pre class="programlisting">typedef struct _GstRTSPConnection GstRTSPConnection;</pre> 2560<p>Opaque RTSP connection object.</p> 2561</div> 2562<hr> 2563<div class="refsect2"> 2564<a name="GstRTSPWatch"></a><h3>GstRTSPWatch</h3> 2565<pre class="programlisting">typedef struct _GstRTSPWatch GstRTSPWatch;</pre> 2566<p>Opaque RTSP watch object that can be used for asynchronous RTSP 2567operations.</p> 2568</div> 2569<hr> 2570<div class="refsect2"> 2571<a name="GstRTSPWatchFuncs"></a><h3>GstRTSPWatchFuncs</h3> 2572<pre class="programlisting">typedef struct { 2573 GstRTSPResult (*message_received) (GstRTSPWatch *watch, GstRTSPMessage *message, 2574 gpointer user_data); 2575 GstRTSPResult (*message_sent) (GstRTSPWatch *watch, guint id, 2576 gpointer user_data); 2577 GstRTSPResult (*closed) (GstRTSPWatch *watch, gpointer user_data); 2578 GstRTSPResult (*error) (GstRTSPWatch *watch, GstRTSPResult result, 2579 gpointer user_data); 2580 GstRTSPStatusCode (*tunnel_start) (GstRTSPWatch *watch, gpointer user_data); 2581 GstRTSPResult (*tunnel_complete) (GstRTSPWatch *watch, gpointer user_data); 2582 GstRTSPResult (*error_full) (GstRTSPWatch *watch, GstRTSPResult result, 2583 GstRTSPMessage *message, guint id, 2584 gpointer user_data); 2585 GstRTSPResult (*tunnel_lost) (GstRTSPWatch *watch, gpointer user_data); 2586 GstRTSPResult (*tunnel_http_response) (GstRTSPWatch *watch, 2587 GstRTSPMessage *request, 2588 GstRTSPMessage *response, 2589 gpointer user_data); 2590} GstRTSPWatchFuncs; 2591</pre> 2592<p>Callback functions from a <a class="link" href="gst-plugins-base-libs-GstRTSPConnection.html#GstRTSPWatch" title="GstRTSPWatch"><span class="type">GstRTSPWatch</span></a>.</p> 2593<div class="refsect3"> 2594<a name="GstRTSPWatchFuncs.members"></a><h4>Members</h4> 2595<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2596<colgroup> 2597<col width="300px" class="struct_members_name"> 2598<col class="struct_members_description"> 2599<col width="200px" class="struct_members_annotations"> 2600</colgroup> 2601<tbody> 2602<tr> 2603<td class="struct_member_name"><p><em class="structfield"><code><a name="GstRTSPWatchFuncs.message-received"></a>message_received</code></em> ()</p></td> 2604<td class="struct_member_description"><p>callback when a message was received</p></td> 2605<td class="struct_member_annotations"> </td> 2606</tr> 2607<tr> 2608<td class="struct_member_name"><p><em class="structfield"><code><a name="GstRTSPWatchFuncs.message-sent"></a>message_sent</code></em> ()</p></td> 2609<td class="struct_member_description"><p>callback when a message was sent</p></td> 2610<td class="struct_member_annotations"> </td> 2611</tr> 2612<tr> 2613<td class="struct_member_name"><p><em class="structfield"><code><a name="GstRTSPWatchFuncs.closed"></a>closed</code></em> ()</p></td> 2614<td class="struct_member_description"><p>callback when the connection is closed</p></td> 2615<td class="struct_member_annotations"> </td> 2616</tr> 2617<tr> 2618<td class="struct_member_name"><p><em class="structfield"><code><a name="GstRTSPWatchFuncs.error"></a>error</code></em> ()</p></td> 2619<td class="struct_member_description"><p>callback when an error occured</p></td> 2620<td class="struct_member_annotations"> </td> 2621</tr> 2622<tr> 2623<td class="struct_member_name"><p><em class="structfield"><code><a name="GstRTSPWatchFuncs.tunnel-start"></a>tunnel_start</code></em> ()</p></td> 2624<td class="struct_member_description"><p>a client started a tunneled connection. The tunnelid of the 2625connection must be saved.</p></td> 2626<td class="struct_member_annotations"> </td> 2627</tr> 2628<tr> 2629<td class="struct_member_name"><p><em class="structfield"><code><a name="GstRTSPWatchFuncs.tunnel-complete"></a>tunnel_complete</code></em> ()</p></td> 2630<td class="struct_member_description"><p>a client finished a tunneled connection. In this callback 2631you usually pair the tunnelid of this connection with the saved one using 2632<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>.</p></td> 2633<td class="struct_member_annotations"> </td> 2634</tr> 2635<tr> 2636<td class="struct_member_name"><p><em class="structfield"><code><a name="GstRTSPWatchFuncs.error-full"></a>error_full</code></em> ()</p></td> 2637<td class="struct_member_description"><p>callback when an error occured with more information than 2638the <em class="parameter"><code>error</code></em> 2639callback.</p></td> 2640<td class="struct_member_annotations"> </td> 2641</tr> 2642<tr> 2643<td class="struct_member_name"><p><em class="structfield"><code><a name="GstRTSPWatchFuncs.tunnel-lost"></a>tunnel_lost</code></em> ()</p></td> 2644<td class="struct_member_description"><p>callback when the post connection of a tunnel is closed.</p></td> 2645<td class="struct_member_annotations"> </td> 2646</tr> 2647<tr> 2648<td class="struct_member_name"><p><em class="structfield"><code><a name="GstRTSPWatchFuncs.tunnel-http-response"></a>tunnel_http_response</code></em> ()</p></td> 2649<td class="struct_member_description"><p>callback when an HTTP response to the GET request 2650is about to be sent for a tunneled connection. The response can be 2651modified in the callback. Since: 1.4.</p></td> 2652<td class="struct_member_annotations"> </td> 2653</tr> 2654</tbody> 2655</table></div> 2656</div> 2657</div> 2658</div> 2659<div class="refsect1"> 2660<a name="gst-plugins-base-libs-GstRTSPConnection.see-also"></a><h2>See Also</h2> 2661<p>gstrtspurl</p> 2662</div> 2663</div> 2664<div class="footer"> 2665<hr>Generated by GTK-Doc V1.28</div> 2666</body> 2667</html>
