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>GstRTSPRange: 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="gst-plugins-base-libs-GstRTSPTimeRange.html" title="GstRTSPTimeRange"> 10<link rel="next" href="GstRTSPUrl.html" title="GstRTSPUrl"> 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-GstRTSPRange.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 19 <a href="#gst-plugins-base-libs-GstRTSPRange.object-hierarchy" class="shortcut">Object Hierarchy</a></span> 20</td> 21<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> 22<td><a accesskey="u" href="gstreamer-rtsp.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 23<td><a accesskey="p" href="gst-plugins-base-libs-GstRTSPTimeRange.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 24<td><a accesskey="n" href="GstRTSPUrl.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> 25</tr></table> 26<div class="refentry"> 27<a name="gst-plugins-base-libs-GstRTSPRange"></a><div class="titlepage"></div> 28<div class="refnamediv"><table width="100%"><tr> 29<td valign="top"> 30<h2><span class="refentrytitle"><a name="gst-plugins-base-libs-GstRTSPRange.top_of_page"></a>GstRTSPRange</span></h2> 31<p>GstRTSPRange — dealing with RTSP transports</p> 32</td> 33<td class="gallery_image" valign="top" align="right"></td> 34</tr></table></div> 35<div class="refsect1"> 36<a name="gst-plugins-base-libs-GstRTSPRange.functions"></a><h2>Functions</h2> 37<div class="informaltable"><table class="informaltable" width="100%" border="0"> 38<colgroup> 39<col width="150px" class="functions_return"> 40<col class="functions_name"> 41</colgroup> 42<tbody> 43<tr> 44<td class="function_type"> 45<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 46</td> 47<td class="function_name"> 48<a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#gst-rtsp-transport-new" title="gst_rtsp_transport_new ()">gst_rtsp_transport_new</a> <span class="c_punctuation">()</span> 49</td> 50</tr> 51<tr> 52<td class="function_type"> 53<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 54</td> 55<td class="function_name"> 56<a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#gst-rtsp-transport-init" title="gst_rtsp_transport_init ()">gst_rtsp_transport_init</a> <span class="c_punctuation">()</span> 57</td> 58</tr> 59<tr> 60<td class="function_type"> 61<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 62</td> 63<td class="function_name"> 64<a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#gst-rtsp-transport-parse" title="gst_rtsp_transport_parse ()">gst_rtsp_transport_parse</a> <span class="c_punctuation">()</span> 65</td> 66</tr> 67<tr> 68<td class="function_type"> 69<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 70</td> 71<td class="function_name"> 72<a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#gst-rtsp-transport-as-text" title="gst_rtsp_transport_as_text ()">gst_rtsp_transport_as_text</a> <span class="c_punctuation">()</span> 73</td> 74</tr> 75<tr> 76<td class="function_type"> 77<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 78</td> 79<td class="function_name"> 80<a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#gst-rtsp-transport-get-mime" title="gst_rtsp_transport_get_mime ()">gst_rtsp_transport_get_mime</a> <span class="c_punctuation">()</span> 81</td> 82</tr> 83<tr> 84<td class="function_type"> 85<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 86</td> 87<td class="function_name"> 88<a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#gst-rtsp-transport-get-manager" title="gst_rtsp_transport_get_manager ()">gst_rtsp_transport_get_manager</a> <span class="c_punctuation">()</span> 89</td> 90</tr> 91<tr> 92<td class="function_type"> 93<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 94</td> 95<td class="function_name"> 96<a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#gst-rtsp-transport-free" title="gst_rtsp_transport_free ()">gst_rtsp_transport_free</a> <span class="c_punctuation">()</span> 97</td> 98</tr> 99</tbody> 100</table></div> 101</div> 102<div class="refsect1"> 103<a name="gst-plugins-base-libs-GstRTSPRange.other"></a><h2>Types and Values</h2> 104<div class="informaltable"><table class="informaltable" width="100%" border="0"> 105<colgroup> 106<col width="150px" class="name"> 107<col class="description"> 108</colgroup> 109<tbody> 110<tr> 111<td class="datatype_keyword">enum</td> 112<td class="function_name"><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransMode" title="enum GstRTSPTransMode">GstRTSPTransMode</a></td> 113</tr> 114<tr> 115<td class="datatype_keyword">enum</td> 116<td class="function_name"><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPProfile" title="enum GstRTSPProfile">GstRTSPProfile</a></td> 117</tr> 118<tr> 119<td class="datatype_keyword">struct</td> 120<td class="function_name"><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPRange" title="struct GstRTSPRange">GstRTSPRange</a></td> 121</tr> 122<tr> 123<td class="datatype_keyword">enum</td> 124<td class="function_name"><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPLowerTrans" title="enum GstRTSPLowerTrans">GstRTSPLowerTrans</a></td> 125</tr> 126<tr> 127<td class="datatype_keyword">struct</td> 128<td class="function_name"><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport">GstRTSPTransport</a></td> 129</tr> 130</tbody> 131</table></div> 132</div> 133<div class="refsect1"> 134<a name="gst-plugins-base-libs-GstRTSPRange.object-hierarchy"></a><h2>Object Hierarchy</h2> 135<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GFlags</a> 136 <span class="lineart">├──</span> GstRTSPLowerTrans 137 <span class="lineart">├──</span> GstRTSPProfile 138 <span class="lineart">╰──</span> GstRTSPTransMode 139</pre> 140</div> 141<div class="refsect1"> 142<a name="gst-plugins-base-libs-GstRTSPRange.includes"></a><h2>Includes</h2> 143<pre class="synopsis">#include <gst/rtsp/rtsp.h> 144</pre> 145</div> 146<div class="refsect1"> 147<a name="gst-plugins-base-libs-GstRTSPRange.description"></a><h2>Description</h2> 148<p>Provides helper functions to deal with RTSP transport strings.</p> 149</div> 150<div class="refsect1"> 151<a name="gst-plugins-base-libs-GstRTSPRange.functions_details"></a><h2>Functions</h2> 152<div class="refsect2"> 153<a name="gst-rtsp-transport-new"></a><h3>gst_rtsp_transport_new ()</h3> 154<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 155gst_rtsp_transport_new (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a> **transport</code></em>);</pre> 156<p>Allocate a new initialized <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a>. Use <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#gst-rtsp-transport-free" title="gst_rtsp_transport_free ()"><code class="function">gst_rtsp_transport_free()</code></a> 157after usage.</p> 158<div class="refsect3"> 159<a name="gst-rtsp-transport-new.parameters"></a><h4>Parameters</h4> 160<div class="informaltable"><table class="informaltable" width="100%" border="0"> 161<colgroup> 162<col width="150px" class="parameters_name"> 163<col class="parameters_description"> 164<col width="200px" class="parameters_annotations"> 165</colgroup> 166<tbody><tr> 167<td class="parameter_name"><p>transport</p></td> 168<td class="parameter_description"><p>location to hold the new <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a></p></td> 169<td class="parameter_annotations"> </td> 170</tr></tbody> 171</table></div> 172</div> 173<div class="refsect3"> 174<a name="gst-rtsp-transport-new.returns"></a><h4>Returns</h4> 175<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 176</div> 177</div> 178<hr> 179<div class="refsect2"> 180<a name="gst-rtsp-transport-init"></a><h3>gst_rtsp_transport_init ()</h3> 181<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 182gst_rtsp_transport_init (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a> *transport</code></em>);</pre> 183<p>Initialize <em class="parameter"><code>transport</code></em> 184 so that it can be used.</p> 185<div class="refsect3"> 186<a name="gst-rtsp-transport-init.parameters"></a><h4>Parameters</h4> 187<div class="informaltable"><table class="informaltable" width="100%" border="0"> 188<colgroup> 189<col width="150px" class="parameters_name"> 190<col class="parameters_description"> 191<col width="200px" class="parameters_annotations"> 192</colgroup> 193<tbody><tr> 194<td class="parameter_name"><p>transport</p></td> 195<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a></p></td> 196<td class="parameter_annotations"> </td> 197</tr></tbody> 198</table></div> 199</div> 200<div class="refsect3"> 201<a name="gst-rtsp-transport-init.returns"></a><h4>Returns</h4> 202<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 203</div> 204</div> 205<hr> 206<div class="refsect2"> 207<a name="gst-rtsp-transport-parse"></a><h3>gst_rtsp_transport_parse ()</h3> 208<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 209gst_rtsp_transport_parse (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>, 210 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a> *transport</code></em>);</pre> 211<p>Parse the RTSP transport string <em class="parameter"><code>str</code></em> 212 into <em class="parameter"><code>transport</code></em> 213.</p> 214<div class="refsect3"> 215<a name="gst-rtsp-transport-parse.parameters"></a><h4>Parameters</h4> 216<div class="informaltable"><table class="informaltable" width="100%" border="0"> 217<colgroup> 218<col width="150px" class="parameters_name"> 219<col class="parameters_description"> 220<col width="200px" class="parameters_annotations"> 221</colgroup> 222<tbody> 223<tr> 224<td class="parameter_name"><p>str</p></td> 225<td class="parameter_description"><p>a transport string</p></td> 226<td class="parameter_annotations"> </td> 227</tr> 228<tr> 229<td class="parameter_name"><p>transport</p></td> 230<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a></p></td> 231<td class="parameter_annotations"> </td> 232</tr> 233</tbody> 234</table></div> 235</div> 236<div class="refsect3"> 237<a name="gst-rtsp-transport-parse.returns"></a><h4>Returns</h4> 238<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 239</div> 240</div> 241<hr> 242<div class="refsect2"> 243<a name="gst-rtsp-transport-as-text"></a><h3>gst_rtsp_transport_as_text ()</h3> 244<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 245gst_rtsp_transport_as_text (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a> *transport</code></em>);</pre> 246<p>Convert <em class="parameter"><code>transport</code></em> 247 into a string that can be used to signal the transport in 248an RTSP SETUP response.</p> 249<div class="refsect3"> 250<a name="gst-rtsp-transport-as-text.parameters"></a><h4>Parameters</h4> 251<div class="informaltable"><table class="informaltable" width="100%" border="0"> 252<colgroup> 253<col width="150px" class="parameters_name"> 254<col class="parameters_description"> 255<col width="200px" class="parameters_annotations"> 256</colgroup> 257<tbody><tr> 258<td class="parameter_name"><p>transport</p></td> 259<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a></p></td> 260<td class="parameter_annotations"> </td> 261</tr></tbody> 262</table></div> 263</div> 264<div class="refsect3"> 265<a name="gst-rtsp-transport-as-text.returns"></a><h4>Returns</h4> 266<p> a string describing the RTSP transport or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> when the transport 267is invalid.</p> 268</div> 269</div> 270<hr> 271<div class="refsect2"> 272<a name="gst-rtsp-transport-get-mime"></a><h3>gst_rtsp_transport_get_mime ()</h3> 273<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 274gst_rtsp_transport_get_mime (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransMode" title="enum GstRTSPTransMode"><span class="type">GstRTSPTransMode</span></a> trans</code></em>, 275 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **mime</code></em>);</pre> 276<div class="warning"> 277<p><code class="literal">gst_rtsp_transport_get_mime</code> is deprecated and should not be used in newly-written code.</p> 278<p>This functions only deals with the GstRTSPTransMode and only 279 returns the mime type for <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GST-RTSP-PROFILE-AVP:CAPS"><span class="type">GST_RTSP_PROFILE_AVP</span></a>. Use 280 <code class="function">gst_rtsp_transport_get_media_type()</code> instead.</p> 281</div> 282<p>Get the mime type of the transport mode <em class="parameter"><code>trans</code></em> 283. This mime type is typically 284used to generate <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> events.</p> 285<div class="refsect3"> 286<a name="gst-rtsp-transport-get-mime.parameters"></a><h4>Parameters</h4> 287<div class="informaltable"><table class="informaltable" width="100%" border="0"> 288<colgroup> 289<col width="150px" class="parameters_name"> 290<col class="parameters_description"> 291<col width="200px" class="parameters_annotations"> 292</colgroup> 293<tbody> 294<tr> 295<td class="parameter_name"><p>trans</p></td> 296<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransMode" title="enum GstRTSPTransMode"><span class="type">GstRTSPTransMode</span></a></p></td> 297<td class="parameter_annotations"> </td> 298</tr> 299<tr> 300<td class="parameter_name"><p>mime</p></td> 301<td class="parameter_description"><p>location to hold the result</p></td> 302<td class="parameter_annotations"> </td> 303</tr> 304</tbody> 305</table></div> 306</div> 307<div class="refsect3"> 308<a name="gst-rtsp-transport-get-mime.returns"></a><h4>Returns</h4> 309<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 310</div> 311</div> 312<hr> 313<div class="refsect2"> 314<a name="gst-rtsp-transport-get-manager"></a><h3>gst_rtsp_transport_get_manager ()</h3> 315<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 316gst_rtsp_transport_get_manager (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransMode" title="enum GstRTSPTransMode"><span class="type">GstRTSPTransMode</span></a> trans</code></em>, 317 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **manager</code></em>, 318 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> option</code></em>);</pre> 319<p>Get the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> that can handle the buffers transported over <em class="parameter"><code>trans</code></em> 320.</p> 321<p>It is possible that there are several managers available, use <em class="parameter"><code>option</code></em> 322 to 323selected one.</p> 324<p><em class="parameter"><code>manager</code></em> 325 will contain an element name or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> when no manager is 326needed/available for <em class="parameter"><code>trans</code></em> 327.</p> 328<div class="refsect3"> 329<a name="gst-rtsp-transport-get-manager.parameters"></a><h4>Parameters</h4> 330<div class="informaltable"><table class="informaltable" width="100%" border="0"> 331<colgroup> 332<col width="150px" class="parameters_name"> 333<col class="parameters_description"> 334<col width="200px" class="parameters_annotations"> 335</colgroup> 336<tbody> 337<tr> 338<td class="parameter_name"><p>trans</p></td> 339<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransMode" title="enum GstRTSPTransMode"><span class="type">GstRTSPTransMode</span></a></p></td> 340<td class="parameter_annotations"> </td> 341</tr> 342<tr> 343<td class="parameter_name"><p>manager</p></td> 344<td class="parameter_description"><p>location to hold the result. </p></td> 345<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 may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 346</tr> 347<tr> 348<td class="parameter_name"><p>option</p></td> 349<td class="parameter_description"><p>option index.</p></td> 350<td class="parameter_annotations"> </td> 351</tr> 352</tbody> 353</table></div> 354</div> 355<div class="refsect3"> 356<a name="gst-rtsp-transport-get-manager.returns"></a><h4>Returns</h4> 357<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 358</div> 359</div> 360<hr> 361<div class="refsect2"> 362<a name="gst-rtsp-transport-free"></a><h3>gst_rtsp_transport_free ()</h3> 363<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 364gst_rtsp_transport_free (<em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a> *transport</code></em>);</pre> 365<p>Free the memory used by <em class="parameter"><code>transport</code></em> 366.</p> 367<div class="refsect3"> 368<a name="gst-rtsp-transport-free.parameters"></a><h4>Parameters</h4> 369<div class="informaltable"><table class="informaltable" width="100%" border="0"> 370<colgroup> 371<col width="150px" class="parameters_name"> 372<col class="parameters_description"> 373<col width="200px" class="parameters_annotations"> 374</colgroup> 375<tbody><tr> 376<td class="parameter_name"><p>transport</p></td> 377<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransport" title="struct GstRTSPTransport"><span class="type">GstRTSPTransport</span></a></p></td> 378<td class="parameter_annotations"> </td> 379</tr></tbody> 380</table></div> 381</div> 382<div class="refsect3"> 383<a name="gst-rtsp-transport-free.returns"></a><h4>Returns</h4> 384<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 385</div> 386</div> 387</div> 388<div class="refsect1"> 389<a name="gst-plugins-base-libs-GstRTSPRange.other_details"></a><h2>Types and Values</h2> 390<div class="refsect2"> 391<a name="GstRTSPTransMode"></a><h3>enum GstRTSPTransMode</h3> 392<p>The transfer mode to use.</p> 393<div class="refsect3"> 394<a name="GstRTSPTransMode.members"></a><h4>Members</h4> 395<div class="informaltable"><table class="informaltable" width="100%" border="0"> 396<colgroup> 397<col width="300px" class="enum_members_name"> 398<col class="enum_members_description"> 399<col width="200px" class="enum_members_annotations"> 400</colgroup> 401<tbody> 402<tr> 403<td class="enum_member_name"><p><a name="GST-RTSP-TRANS-UNKNOWN:CAPS"></a>GST_RTSP_TRANS_UNKNOWN</p></td> 404<td class="enum_member_description"> 405<p>invalid tansport mode</p> 406</td> 407<td class="enum_member_annotations"> </td> 408</tr> 409<tr> 410<td class="enum_member_name"><p><a name="GST-RTSP-TRANS-RTP:CAPS"></a>GST_RTSP_TRANS_RTP</p></td> 411<td class="enum_member_description"> 412<p>transfer RTP data</p> 413</td> 414<td class="enum_member_annotations"> </td> 415</tr> 416<tr> 417<td class="enum_member_name"><p><a name="GST-RTSP-TRANS-RDT:CAPS"></a>GST_RTSP_TRANS_RDT</p></td> 418<td class="enum_member_description"> 419<p>transfer RDT (RealMedia) data</p> 420</td> 421<td class="enum_member_annotations"> </td> 422</tr> 423</tbody> 424</table></div> 425</div> 426</div> 427<hr> 428<div class="refsect2"> 429<a name="GstRTSPProfile"></a><h3>enum GstRTSPProfile</h3> 430<p>The transfer profile to use.</p> 431<div class="refsect3"> 432<a name="GstRTSPProfile.members"></a><h4>Members</h4> 433<div class="informaltable"><table class="informaltable" width="100%" border="0"> 434<colgroup> 435<col width="300px" class="enum_members_name"> 436<col class="enum_members_description"> 437<col width="200px" class="enum_members_annotations"> 438</colgroup> 439<tbody> 440<tr> 441<td class="enum_member_name"><p><a name="GST-RTSP-PROFILE-UNKNOWN:CAPS"></a>GST_RTSP_PROFILE_UNKNOWN</p></td> 442<td class="enum_member_description"> 443<p>invalid profile</p> 444</td> 445<td class="enum_member_annotations"> </td> 446</tr> 447<tr> 448<td class="enum_member_name"><p><a name="GST-RTSP-PROFILE-AVP:CAPS"></a>GST_RTSP_PROFILE_AVP</p></td> 449<td class="enum_member_description"> 450<p>the Audio/Visual profile (RFC 3551)</p> 451</td> 452<td class="enum_member_annotations"> </td> 453</tr> 454<tr> 455<td class="enum_member_name"><p><a name="GST-RTSP-PROFILE-SAVP:CAPS"></a>GST_RTSP_PROFILE_SAVP</p></td> 456<td class="enum_member_description"> 457<p>the secure Audio/Visual profile (RFC 3711)</p> 458</td> 459<td class="enum_member_annotations"> </td> 460</tr> 461<tr> 462<td class="enum_member_name"><p><a name="GST-RTSP-PROFILE-AVPF:CAPS"></a>GST_RTSP_PROFILE_AVPF</p></td> 463<td class="enum_member_description"> 464<p>the Audio/Visual profile with feedback (RFC 4585)</p> 465</td> 466<td class="enum_member_annotations"> </td> 467</tr> 468<tr> 469<td class="enum_member_name"><p><a name="GST-RTSP-PROFILE-SAVPF:CAPS"></a>GST_RTSP_PROFILE_SAVPF</p></td> 470<td class="enum_member_description"> 471<p>the secure Audio/Visual profile with feedback (RFC 5124)</p> 472</td> 473<td class="enum_member_annotations"> </td> 474</tr> 475</tbody> 476</table></div> 477</div> 478</div> 479<hr> 480<div class="refsect2"> 481<a name="GstRTSPRange"></a><h3>struct GstRTSPRange</h3> 482<pre class="programlisting">struct GstRTSPRange { 483 gint min; 484 gint max; 485}; 486</pre> 487<p>A type to specify a range.</p> 488<div class="refsect3"> 489<a name="GstRTSPRange.members"></a><h4>Members</h4> 490<div class="informaltable"><table class="informaltable" width="100%" border="0"> 491<colgroup> 492<col width="300px" class="struct_members_name"> 493<col class="struct_members_description"> 494<col width="200px" class="struct_members_annotations"> 495</colgroup> 496<tbody> 497<tr> 498<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GstRTSPRange.min"></a>min</code></em>;</p></td> 499<td class="struct_member_description"><p>minimum value of the range</p></td> 500<td class="struct_member_annotations"> </td> 501</tr> 502<tr> 503<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="GstRTSPRange.max"></a>max</code></em>;</p></td> 504<td class="struct_member_description"><p>maximum value of the range</p></td> 505<td class="struct_member_annotations"> </td> 506</tr> 507</tbody> 508</table></div> 509</div> 510</div> 511<hr> 512<div class="refsect2"> 513<a name="GstRTSPLowerTrans"></a><h3>enum GstRTSPLowerTrans</h3> 514<p>The different transport methods.</p> 515<div class="refsect3"> 516<a name="GstRTSPLowerTrans.members"></a><h4>Members</h4> 517<div class="informaltable"><table class="informaltable" width="100%" border="0"> 518<colgroup> 519<col width="300px" class="enum_members_name"> 520<col class="enum_members_description"> 521<col width="200px" class="enum_members_annotations"> 522</colgroup> 523<tbody> 524<tr> 525<td class="enum_member_name"><p><a name="GST-RTSP-LOWER-TRANS-UNKNOWN:CAPS"></a>GST_RTSP_LOWER_TRANS_UNKNOWN</p></td> 526<td class="enum_member_description"> 527<p>invalid transport flag</p> 528</td> 529<td class="enum_member_annotations"> </td> 530</tr> 531<tr> 532<td class="enum_member_name"><p><a name="GST-RTSP-LOWER-TRANS-UDP:CAPS"></a>GST_RTSP_LOWER_TRANS_UDP</p></td> 533<td class="enum_member_description"> 534<p>stream data over UDP</p> 535</td> 536<td class="enum_member_annotations"> </td> 537</tr> 538<tr> 539<td class="enum_member_name"><p><a name="GST-RTSP-LOWER-TRANS-UDP-MCAST:CAPS"></a>GST_RTSP_LOWER_TRANS_UDP_MCAST</p></td> 540<td class="enum_member_description"> 541<p>stream data over UDP multicast</p> 542</td> 543<td class="enum_member_annotations"> </td> 544</tr> 545<tr> 546<td class="enum_member_name"><p><a name="GST-RTSP-LOWER-TRANS-TCP:CAPS"></a>GST_RTSP_LOWER_TRANS_TCP</p></td> 547<td class="enum_member_description"> 548<p>stream data over TCP</p> 549</td> 550<td class="enum_member_annotations"> </td> 551</tr> 552<tr> 553<td class="enum_member_name"><p><a name="GST-RTSP-LOWER-TRANS-HTTP:CAPS"></a>GST_RTSP_LOWER_TRANS_HTTP</p></td> 554<td class="enum_member_description"> 555<p>stream data tunneled over HTTP.</p> 556</td> 557<td class="enum_member_annotations"> </td> 558</tr> 559<tr> 560<td class="enum_member_name"><p><a name="GST-RTSP-LOWER-TRANS-TLS:CAPS"></a>GST_RTSP_LOWER_TRANS_TLS</p></td> 561<td class="enum_member_description"> 562<p>encrypt TCP and HTTP with TLS</p> 563</td> 564<td class="enum_member_annotations"> </td> 565</tr> 566</tbody> 567</table></div> 568</div> 569</div> 570<hr> 571<div class="refsect2"> 572<a name="GstRTSPTransport"></a><h3>struct GstRTSPTransport</h3> 573<pre class="programlisting">struct GstRTSPTransport { 574 GstRTSPTransMode trans; 575 GstRTSPProfile profile; 576 GstRTSPLowerTrans lower_transport; 577 578 gchar *destination; 579 gchar *source; 580 guint layers; 581 gboolean mode_play; 582 gboolean mode_record; 583 gboolean append; 584 GstRTSPRange interleaved; 585 586 /* multicast specific */ 587 guint ttl; 588 GstRTSPRange port; 589 590 /* UDP/TCP specific */ 591 GstRTSPRange client_port; 592 GstRTSPRange server_port; 593 /* RTP specific */ 594 guint ssrc; 595}; 596</pre> 597<p>A structure holding the RTSP transport values.</p> 598<div class="refsect3"> 599<a name="GstRTSPTransport.members"></a><h4>Members</h4> 600<div class="informaltable"><table class="informaltable" width="100%" border="0"> 601<colgroup> 602<col width="300px" class="struct_members_name"> 603<col class="struct_members_description"> 604<col width="200px" class="struct_members_annotations"> 605</colgroup> 606<tbody> 607<tr> 608<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPTransMode" title="enum GstRTSPTransMode"><span class="type">GstRTSPTransMode</span></a> <em class="structfield"><code><a name="GstRTSPTransport.trans"></a>trans</code></em>;</p></td> 609<td class="struct_member_description"><p>the transport mode</p></td> 610<td class="struct_member_annotations"> </td> 611</tr> 612<tr> 613<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPProfile" title="enum GstRTSPProfile"><span class="type">GstRTSPProfile</span></a> <em class="structfield"><code><a name="GstRTSPTransport.profile"></a>profile</code></em>;</p></td> 614<td class="struct_member_description"><p>the tansport profile</p></td> 615<td class="struct_member_annotations"> </td> 616</tr> 617<tr> 618<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPLowerTrans" title="enum GstRTSPLowerTrans"><span class="type">GstRTSPLowerTrans</span></a> <em class="structfield"><code><a name="GstRTSPTransport.lower-transport"></a>lower_transport</code></em>;</p></td> 619<td class="struct_member_description"><p>the lower transport</p></td> 620<td class="struct_member_annotations"> </td> 621</tr> 622<tr> 623<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPTransport.destination"></a>destination</code></em>;</p></td> 624<td class="struct_member_description"><p>the destination ip/hostname</p></td> 625<td class="struct_member_annotations"> </td> 626</tr> 627<tr> 628<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTSPTransport.source"></a>source</code></em>;</p></td> 629<td class="struct_member_description"><p>the source ip/hostname</p></td> 630<td class="struct_member_annotations"> </td> 631</tr> 632<tr> 633<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GstRTSPTransport.layers"></a>layers</code></em>;</p></td> 634<td class="struct_member_description"><p>the number of layers</p></td> 635<td class="struct_member_annotations"> </td> 636</tr> 637<tr> 638<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> <em class="structfield"><code><a name="GstRTSPTransport.mode-play"></a>mode_play</code></em>;</p></td> 639<td class="struct_member_description"><p>if play mode was selected</p></td> 640<td class="struct_member_annotations"> </td> 641</tr> 642<tr> 643<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> <em class="structfield"><code><a name="GstRTSPTransport.mode-record"></a>mode_record</code></em>;</p></td> 644<td class="struct_member_description"><p>if record mode was selected</p></td> 645<td class="struct_member_annotations"> </td> 646</tr> 647<tr> 648<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> <em class="structfield"><code><a name="GstRTSPTransport.append"></a>append</code></em>;</p></td> 649<td class="struct_member_description"><p>is append mode was selected</p></td> 650<td class="struct_member_annotations"> </td> 651</tr> 652<tr> 653<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPRange" title="struct GstRTSPRange"><span class="type">GstRTSPRange</span></a> <em class="structfield"><code><a name="GstRTSPTransport.interleaved"></a>interleaved</code></em>;</p></td> 654<td class="struct_member_description"><p>the interleave range</p></td> 655<td class="struct_member_annotations"> </td> 656</tr> 657<tr> 658<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GstRTSPTransport.ttl"></a>ttl</code></em>;</p></td> 659<td class="struct_member_description"><p>the time to live for multicast UDP</p></td> 660<td class="struct_member_annotations"> </td> 661</tr> 662<tr> 663<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPRange" title="struct GstRTSPRange"><span class="type">GstRTSPRange</span></a> <em class="structfield"><code><a name="GstRTSPTransport.port"></a>port</code></em>;</p></td> 664<td class="struct_member_description"><p>the port pair for multicast sessions</p></td> 665<td class="struct_member_annotations"> </td> 666</tr> 667<tr> 668<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPRange" title="struct GstRTSPRange"><span class="type">GstRTSPRange</span></a> <em class="structfield"><code><a name="GstRTSPTransport.client-port"></a>client_port</code></em>;</p></td> 669<td class="struct_member_description"><p>the client port pair for receiving data. For TCP 670based transports, applications can use this field to store the 671sender and receiver ports of the client.</p></td> 672<td class="struct_member_annotations"> </td> 673</tr> 674<tr> 675<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-GstRTSPRange.html#GstRTSPRange" title="struct GstRTSPRange"><span class="type">GstRTSPRange</span></a> <em class="structfield"><code><a name="GstRTSPTransport.server-port"></a>server_port</code></em>;</p></td> 676<td class="struct_member_description"><p>the server port pair for receiving data. For TCP 677based transports, applications can use this field to store the 678sender and receiver ports of the server.</p></td> 679<td class="struct_member_annotations"> </td> 680</tr> 681<tr> 682<td class="struct_member_name"><p><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GstRTSPTransport.ssrc"></a>ssrc</code></em>;</p></td> 683<td class="struct_member_description"><p>the ssrc that the sender/receiver will use</p></td> 684<td class="struct_member_annotations"> </td> 685</tr> 686</tbody> 687</table></div> 688</div> 689</div> 690</div> 691</div> 692<div class="footer"> 693<hr>Generated by GTK-Doc V1.28</div> 694</body> 695</html>