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>GstRTSPMessage: 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="GstRTSPExtension.html" title="GstRTSPExtension"> 10<link rel="next" href="gst-plugins-base-libs-GstRTSPTimeRange.html" title="GstRTSPTimeRange"> 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="#GstRTSPMessage.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 19 <a href="#GstRTSPMessage.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="GstRTSPExtension.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 24<td><a accesskey="n" href="gst-plugins-base-libs-GstRTSPTimeRange.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="GstRTSPMessage"></a><div class="titlepage"></div> 28<div class="refnamediv"><table width="100%"><tr> 29<td valign="top"> 30<h2><span class="refentrytitle"><a name="GstRTSPMessage.top_of_page"></a>GstRTSPMessage</span></h2> 31<p>GstRTSPMessage — RTSP messages</p> 32</td> 33<td class="gallery_image" valign="top" align="right"></td> 34</tr></table></div> 35<div class="refsect1"> 36<a name="GstRTSPMessage.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="GstRTSPMessage.html#gst-rtsp-message-new" title="gst_rtsp_message_new ()">gst_rtsp_message_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="GstRTSPMessage.html#gst-rtsp-message-init" title="gst_rtsp_message_init ()">gst_rtsp_message_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="GstRTSPMessage.html#gst-rtsp-message-unset" title="gst_rtsp_message_unset ()">gst_rtsp_message_unset</a> <span class="c_punctuation">()</span> 65</td> 66</tr> 67<tr> 68<td class="function_type"> 69<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 70</td> 71<td class="function_name"> 72<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-copy" title="gst_rtsp_message_copy ()">gst_rtsp_message_copy</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="GstRTSPMessage.html#gst-rtsp-message-free" title="gst_rtsp_message_free ()">gst_rtsp_message_free</a> <span class="c_punctuation">()</span> 81</td> 82</tr> 83<tr> 84<td class="function_type"> 85<a class="link" href="GstRTSPMessage.html#GstRTSPMsgType" title="enum GstRTSPMsgType"><span class="returnvalue">GstRTSPMsgType</span></a> 86</td> 87<td class="function_name"> 88<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-get-type" title="gst_rtsp_message_get_type ()">gst_rtsp_message_get_type</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="GstRTSPMessage.html#gst-rtsp-message-new-request" title="gst_rtsp_message_new_request ()">gst_rtsp_message_new_request</a> <span class="c_punctuation">()</span> 97</td> 98</tr> 99<tr> 100<td class="function_type"> 101<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 102</td> 103<td class="function_name"> 104<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-init-request" title="gst_rtsp_message_init_request ()">gst_rtsp_message_init_request</a> <span class="c_punctuation">()</span> 105</td> 106</tr> 107<tr> 108<td class="function_type"> 109<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 110</td> 111<td class="function_name"> 112<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-parse-request" title="gst_rtsp_message_parse_request ()">gst_rtsp_message_parse_request</a> <span class="c_punctuation">()</span> 113</td> 114</tr> 115<tr> 116<td class="function_type"> 117<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 118</td> 119<td class="function_name"> 120<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-new-response" title="gst_rtsp_message_new_response ()">gst_rtsp_message_new_response</a> <span class="c_punctuation">()</span> 121</td> 122</tr> 123<tr> 124<td class="function_type"> 125<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 126</td> 127<td class="function_name"> 128<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-init-response" title="gst_rtsp_message_init_response ()">gst_rtsp_message_init_response</a> <span class="c_punctuation">()</span> 129</td> 130</tr> 131<tr> 132<td class="function_type"> 133<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 134</td> 135<td class="function_name"> 136<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-parse-response" title="gst_rtsp_message_parse_response ()">gst_rtsp_message_parse_response</a> <span class="c_punctuation">()</span> 137</td> 138</tr> 139<tr> 140<td class="function_type"> 141<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 142</td> 143<td class="function_name"> 144<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-new-data" title="gst_rtsp_message_new_data ()">gst_rtsp_message_new_data</a> <span class="c_punctuation">()</span> 145</td> 146</tr> 147<tr> 148<td class="function_type"> 149<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 150</td> 151<td class="function_name"> 152<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-init-data" title="gst_rtsp_message_init_data ()">gst_rtsp_message_init_data</a> <span class="c_punctuation">()</span> 153</td> 154</tr> 155<tr> 156<td class="function_type"> 157<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 158</td> 159<td class="function_name"> 160<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-parse-data" title="gst_rtsp_message_parse_data ()">gst_rtsp_message_parse_data</a> <span class="c_punctuation">()</span> 161</td> 162</tr> 163<tr> 164<td class="function_type"> 165<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 166</td> 167<td class="function_name"> 168<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-add-header" title="gst_rtsp_message_add_header ()">gst_rtsp_message_add_header</a> <span class="c_punctuation">()</span> 169</td> 170</tr> 171<tr> 172<td class="function_type"> 173<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 174</td> 175<td class="function_name"> 176<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-take-header" title="gst_rtsp_message_take_header ()">gst_rtsp_message_take_header</a> <span class="c_punctuation">()</span> 177</td> 178</tr> 179<tr> 180<td class="function_type"> 181<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 182</td> 183<td class="function_name"> 184<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-remove-header" title="gst_rtsp_message_remove_header ()">gst_rtsp_message_remove_header</a> <span class="c_punctuation">()</span> 185</td> 186</tr> 187<tr> 188<td class="function_type"> 189<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 190</td> 191<td class="function_name"> 192<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-get-header" title="gst_rtsp_message_get_header ()">gst_rtsp_message_get_header</a> <span class="c_punctuation">()</span> 193</td> 194</tr> 195<tr> 196<td class="function_type"> 197<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 198</td> 199<td class="function_name"> 200<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-add-header-by-name" title="gst_rtsp_message_add_header_by_name ()">gst_rtsp_message_add_header_by_name</a> <span class="c_punctuation">()</span> 201</td> 202</tr> 203<tr> 204<td class="function_type"> 205<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 206</td> 207<td class="function_name"> 208<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-take-header-by-name" title="gst_rtsp_message_take_header_by_name ()">gst_rtsp_message_take_header_by_name</a> <span class="c_punctuation">()</span> 209</td> 210</tr> 211<tr> 212<td class="function_type"> 213<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 214</td> 215<td class="function_name"> 216<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-remove-header-by-name" title="gst_rtsp_message_remove_header_by_name ()">gst_rtsp_message_remove_header_by_name</a> <span class="c_punctuation">()</span> 217</td> 218</tr> 219<tr> 220<td class="function_type"> 221<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 222</td> 223<td class="function_name"> 224<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-get-header-by-name" title="gst_rtsp_message_get_header_by_name ()">gst_rtsp_message_get_header_by_name</a> <span class="c_punctuation">()</span> 225</td> 226</tr> 227<tr> 228<td class="function_type"> 229<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 230</td> 231<td class="function_name"> 232<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-append-headers" title="gst_rtsp_message_append_headers ()">gst_rtsp_message_append_headers</a> <span class="c_punctuation">()</span> 233</td> 234</tr> 235<tr> 236<td class="function_type"> 237<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 238</td> 239<td class="function_name"> 240<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-set-body" title="gst_rtsp_message_set_body ()">gst_rtsp_message_set_body</a> <span class="c_punctuation">()</span> 241</td> 242</tr> 243<tr> 244<td class="function_type"> 245<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 246</td> 247<td class="function_name"> 248<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-take-body" title="gst_rtsp_message_take_body ()">gst_rtsp_message_take_body</a> <span class="c_punctuation">()</span> 249</td> 250</tr> 251<tr> 252<td class="function_type"> 253<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 254</td> 255<td class="function_name"> 256<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-get-body" title="gst_rtsp_message_get_body ()">gst_rtsp_message_get_body</a> <span class="c_punctuation">()</span> 257</td> 258</tr> 259<tr> 260<td class="function_type"> 261<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 262</td> 263<td class="function_name"> 264<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-steal-body" title="gst_rtsp_message_steal_body ()">gst_rtsp_message_steal_body</a> <span class="c_punctuation">()</span> 265</td> 266</tr> 267<tr> 268<td class="function_type"> 269<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 270</td> 271<td class="function_name"> 272<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-set-body-buffer" title="gst_rtsp_message_set_body_buffer ()">gst_rtsp_message_set_body_buffer</a> <span class="c_punctuation">()</span> 273</td> 274</tr> 275<tr> 276<td class="function_type"> 277<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 278</td> 279<td class="function_name"> 280<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-take-body-buffer" title="gst_rtsp_message_take_body_buffer ()">gst_rtsp_message_take_body_buffer</a> <span class="c_punctuation">()</span> 281</td> 282</tr> 283<tr> 284<td class="function_type"> 285<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 286</td> 287<td class="function_name"> 288<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-has-body-buffer" title="gst_rtsp_message_has_body_buffer ()">gst_rtsp_message_has_body_buffer</a> <span class="c_punctuation">()</span> 289</td> 290</tr> 291<tr> 292<td class="function_type"> 293<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 294</td> 295<td class="function_name"> 296<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-get-body-buffer" title="gst_rtsp_message_get_body_buffer ()">gst_rtsp_message_get_body_buffer</a> <span class="c_punctuation">()</span> 297</td> 298</tr> 299<tr> 300<td class="function_type"> 301<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 302</td> 303<td class="function_name"> 304<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-steal-body-buffer" title="gst_rtsp_message_steal_body_buffer ()">gst_rtsp_message_steal_body_buffer</a> <span class="c_punctuation">()</span> 305</td> 306</tr> 307<tr> 308<td class="function_type"> 309<a class="link" href="GstRTSPMessage.html#GstRTSPAuthCredential"><span class="returnvalue">GstRTSPAuthCredential</span></a> ** 310</td> 311<td class="function_name"> 312<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-parse-auth-credentials" title="gst_rtsp_message_parse_auth_credentials ()">gst_rtsp_message_parse_auth_credentials</a> <span class="c_punctuation">()</span> 313</td> 314</tr> 315<tr> 316<td class="function_type"> 317<span class="returnvalue">void</span> 318</td> 319<td class="function_name"> 320<a class="link" href="GstRTSPMessage.html#gst-rtsp-auth-credentials-free" title="gst_rtsp_auth_credentials_free ()">gst_rtsp_auth_credentials_free</a> <span class="c_punctuation">()</span> 321</td> 322</tr> 323<tr> 324<td class="function_type"> 325<a class="link" href="GstRTSPMessage.html#GstRTSPAuthParam"><span class="returnvalue">GstRTSPAuthParam</span></a> * 326</td> 327<td class="function_name"> 328<a class="link" href="GstRTSPMessage.html#gst-rtsp-auth-param-copy" title="gst_rtsp_auth_param_copy ()">gst_rtsp_auth_param_copy</a> <span class="c_punctuation">()</span> 329</td> 330</tr> 331<tr> 332<td class="function_type"> 333<span class="returnvalue">void</span> 334</td> 335<td class="function_name"> 336<a class="link" href="GstRTSPMessage.html#gst-rtsp-auth-param-free" title="gst_rtsp_auth_param_free ()">gst_rtsp_auth_param_free</a> <span class="c_punctuation">()</span> 337</td> 338</tr> 339<tr> 340<td class="function_type"> 341<a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 342</td> 343<td class="function_name"> 344<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-dump" title="gst_rtsp_message_dump ()">gst_rtsp_message_dump</a> <span class="c_punctuation">()</span> 345</td> 346</tr> 347</tbody> 348</table></div> 349</div> 350<a name="GstRTSPAuthCredential"></a><a name="GstRTSPAuthParam"></a><div class="refsect1"> 351<a name="GstRTSPMessage.other"></a><h2>Types and Values</h2> 352<div class="informaltable"><table class="informaltable" width="100%" border="0"> 353<colgroup> 354<col width="150px" class="name"> 355<col class="description"> 356</colgroup> 357<tbody> 358<tr> 359<td class="datatype_keyword">enum</td> 360<td class="function_name"><a class="link" href="GstRTSPMessage.html#GstRTSPMsgType" title="enum GstRTSPMsgType">GstRTSPMsgType</a></td> 361</tr> 362<tr> 363<td class="datatype_keyword">struct</td> 364<td class="function_name"><a class="link" href="GstRTSPMessage.html#GstRTSPMessage-struct" title="struct GstRTSPMessage">GstRTSPMessage</a></td> 365</tr> 366<tr> 367<td class="datatype_keyword">struct</td> 368<td class="function_name"><a class="link" href="GstRTSPMessage.html#GstRTSPAuthCredential-struct" title="struct GstRTSPAuthCredential">GstRTSPAuthCredential</a></td> 369</tr> 370<tr> 371<td class="datatype_keyword">struct</td> 372<td class="function_name"><a class="link" href="GstRTSPMessage.html#GstRTSPAuthParam-struct" title="struct GstRTSPAuthParam">GstRTSPAuthParam</a></td> 373</tr> 374</tbody> 375</table></div> 376</div> 377<div class="refsect1"> 378<a name="GstRTSPMessage.object-hierarchy"></a><h2>Object Hierarchy</h2> 379<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a> 380 <span class="lineart">├──</span> GstRTSPAuthCredential 381 <span class="lineart">├──</span> GstRTSPAuthParam 382 <span class="lineart">╰──</span> GstRTSPMessage 383 <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GEnum</a> 384 <span class="lineart">╰──</span> GstRTSPMsgType 385</pre> 386</div> 387<div class="refsect1"> 388<a name="GstRTSPMessage.includes"></a><h2>Includes</h2> 389<pre class="synopsis">#include <gst/rtsp/rtsp.h> 390</pre> 391</div> 392<div class="refsect1"> 393<a name="GstRTSPMessage.description"></a><h2>Description</h2> 394<p>Provides methods for creating and parsing request, response and data messages.</p> 395</div> 396<div class="refsect1"> 397<a name="GstRTSPMessage.functions_details"></a><h2>Functions</h2> 398<div class="refsect2"> 399<a name="gst-rtsp-message-new"></a><h3>gst_rtsp_message_new ()</h3> 400<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 401gst_rtsp_message_new (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> **msg</code></em>);</pre> 402<p>Create a new initialized <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a>. Free with <a class="link" href="GstRTSPMessage.html#gst-rtsp-message-free" title="gst_rtsp_message_free ()"><code class="function">gst_rtsp_message_free()</code></a>.</p> 403<div class="refsect3"> 404<a name="gst-rtsp-message-new.parameters"></a><h4>Parameters</h4> 405<div class="informaltable"><table class="informaltable" width="100%" border="0"> 406<colgroup> 407<col width="150px" class="parameters_name"> 408<col class="parameters_description"> 409<col width="200px" class="parameters_annotations"> 410</colgroup> 411<tbody><tr> 412<td class="parameter_name"><p>msg</p></td> 413<td class="parameter_description"><p>a location for the new <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a>. </p></td> 414<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> 415</tr></tbody> 416</table></div> 417</div> 418<div class="refsect3"> 419<a name="gst-rtsp-message-new.returns"></a><h4>Returns</h4> 420<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 421</div> 422</div> 423<hr> 424<div class="refsect2"> 425<a name="gst-rtsp-message-init"></a><h3>gst_rtsp_message_init ()</h3> 426<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 427gst_rtsp_message_init (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>);</pre> 428<p>Initialize <em class="parameter"><code>msg</code></em> 429. This function is mostly used when <em class="parameter"><code>msg</code></em> 430 is allocated on the 431stack. The reverse operation of this is <a class="link" href="GstRTSPMessage.html#gst-rtsp-message-unset" title="gst_rtsp_message_unset ()"><code class="function">gst_rtsp_message_unset()</code></a>.</p> 432<div class="refsect3"> 433<a name="gst-rtsp-message-init.parameters"></a><h4>Parameters</h4> 434<div class="informaltable"><table class="informaltable" width="100%" border="0"> 435<colgroup> 436<col width="150px" class="parameters_name"> 437<col class="parameters_description"> 438<col width="200px" class="parameters_annotations"> 439</colgroup> 440<tbody><tr> 441<td class="parameter_name"><p>msg</p></td> 442<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 443<td class="parameter_annotations"> </td> 444</tr></tbody> 445</table></div> 446</div> 447<div class="refsect3"> 448<a name="gst-rtsp-message-init.returns"></a><h4>Returns</h4> 449<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 450</div> 451</div> 452<hr> 453<div class="refsect2"> 454<a name="gst-rtsp-message-unset"></a><h3>gst_rtsp_message_unset ()</h3> 455<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 456gst_rtsp_message_unset (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>);</pre> 457<p>Unset the contents of <em class="parameter"><code>msg</code></em> 458 so that it becomes an uninitialized 459<a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> again. This function is mostly used in combination with 460<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-init-request" title="gst_rtsp_message_init_request ()"><code class="function">gst_rtsp_message_init_request()</code></a>, <a class="link" href="GstRTSPMessage.html#gst-rtsp-message-init-response" title="gst_rtsp_message_init_response ()"><code class="function">gst_rtsp_message_init_response()</code></a> and 461<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-init-data" title="gst_rtsp_message_init_data ()"><code class="function">gst_rtsp_message_init_data()</code></a> on stack allocated <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> structures.</p> 462<div class="refsect3"> 463<a name="gst-rtsp-message-unset.parameters"></a><h4>Parameters</h4> 464<div class="informaltable"><table class="informaltable" width="100%" border="0"> 465<colgroup> 466<col width="150px" class="parameters_name"> 467<col class="parameters_description"> 468<col width="200px" class="parameters_annotations"> 469</colgroup> 470<tbody><tr> 471<td class="parameter_name"><p>msg</p></td> 472<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 473<td class="parameter_annotations"> </td> 474</tr></tbody> 475</table></div> 476</div> 477<div class="refsect3"> 478<a name="gst-rtsp-message-unset.returns"></a><h4>Returns</h4> 479<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 480</div> 481</div> 482<hr> 483<div class="refsect2"> 484<a name="gst-rtsp-message-copy"></a><h3>gst_rtsp_message_copy ()</h3> 485<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 486gst_rtsp_message_copy (<em class="parameter"><code>const <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 487 <em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> **copy</code></em>);</pre> 488<p>Allocate a new copy of <em class="parameter"><code>msg</code></em> 489 and store the result in <em class="parameter"><code>copy</code></em> 490. The value in 491<em class="parameter"><code>copy</code></em> 492 should be release with gst_rtsp_message_free function.</p> 493<div class="refsect3"> 494<a name="gst-rtsp-message-copy.parameters"></a><h4>Parameters</h4> 495<div class="informaltable"><table class="informaltable" width="100%" border="0"> 496<colgroup> 497<col width="150px" class="parameters_name"> 498<col class="parameters_description"> 499<col width="200px" class="parameters_annotations"> 500</colgroup> 501<tbody> 502<tr> 503<td class="parameter_name"><p>msg</p></td> 504<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 505<td class="parameter_annotations"> </td> 506</tr> 507<tr> 508<td class="parameter_name"><p>copy</p></td> 509<td class="parameter_description"><p>pointer to new <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a>. </p></td> 510<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> 511</tr> 512</tbody> 513</table></div> 514</div> 515<div class="refsect3"> 516<a name="gst-rtsp-message-copy.returns"></a><h4>Returns</h4> 517<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a></p> 518</div> 519<p class="since">Since: <a class="link" href="ix04.html#api-index-1.14">1.14</a></p> 520</div> 521<hr> 522<div class="refsect2"> 523<a name="gst-rtsp-message-free"></a><h3>gst_rtsp_message_free ()</h3> 524<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 525gst_rtsp_message_free (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>);</pre> 526<p>Free the memory used by <em class="parameter"><code>msg</code></em> 527.</p> 528<div class="refsect3"> 529<a name="gst-rtsp-message-free.parameters"></a><h4>Parameters</h4> 530<div class="informaltable"><table class="informaltable" width="100%" border="0"> 531<colgroup> 532<col width="150px" class="parameters_name"> 533<col class="parameters_description"> 534<col width="200px" class="parameters_annotations"> 535</colgroup> 536<tbody><tr> 537<td class="parameter_name"><p>msg</p></td> 538<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 539<td class="parameter_annotations"> </td> 540</tr></tbody> 541</table></div> 542</div> 543<div class="refsect3"> 544<a name="gst-rtsp-message-free.returns"></a><h4>Returns</h4> 545<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 546</div> 547</div> 548<hr> 549<div class="refsect2"> 550<a name="gst-rtsp-message-get-type"></a><h3>gst_rtsp_message_get_type ()</h3> 551<pre class="programlisting"><a class="link" href="GstRTSPMessage.html#GstRTSPMsgType" title="enum GstRTSPMsgType"><span class="returnvalue">GstRTSPMsgType</span></a> 552gst_rtsp_message_get_type (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>);</pre> 553<p>Get the message type of <em class="parameter"><code>msg</code></em> 554.</p> 555<div class="refsect3"> 556<a name="gst-rtsp-message-get-type.parameters"></a><h4>Parameters</h4> 557<div class="informaltable"><table class="informaltable" width="100%" border="0"> 558<colgroup> 559<col width="150px" class="parameters_name"> 560<col class="parameters_description"> 561<col width="200px" class="parameters_annotations"> 562</colgroup> 563<tbody><tr> 564<td class="parameter_name"><p>msg</p></td> 565<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 566<td class="parameter_annotations"> </td> 567</tr></tbody> 568</table></div> 569</div> 570<div class="refsect3"> 571<a name="gst-rtsp-message-get-type.returns"></a><h4>Returns</h4> 572<p> the message type.</p> 573</div> 574</div> 575<hr> 576<div class="refsect2"> 577<a name="gst-rtsp-message-new-request"></a><h3>gst_rtsp_message_new_request ()</h3> 578<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 579gst_rtsp_message_new_request (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> **msg</code></em>, 580 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPMethod" title="enum GstRTSPMethod"><span class="type">GstRTSPMethod</span></a> method</code></em>, 581 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>);</pre> 582<p>Create a new <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> with <em class="parameter"><code>method</code></em> 583 and <em class="parameter"><code>uri</code></em> 584 and store the result 585request message in <em class="parameter"><code>msg</code></em> 586. Free with <a class="link" href="GstRTSPMessage.html#gst-rtsp-message-free" title="gst_rtsp_message_free ()"><code class="function">gst_rtsp_message_free()</code></a>.</p> 587<div class="refsect3"> 588<a name="gst-rtsp-message-new-request.parameters"></a><h4>Parameters</h4> 589<div class="informaltable"><table class="informaltable" width="100%" border="0"> 590<colgroup> 591<col width="150px" class="parameters_name"> 592<col class="parameters_description"> 593<col width="200px" class="parameters_annotations"> 594</colgroup> 595<tbody> 596<tr> 597<td class="parameter_name"><p>msg</p></td> 598<td class="parameter_description"><p>a location for the new <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a>. </p></td> 599<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> 600</tr> 601<tr> 602<td class="parameter_name"><p>method</p></td> 603<td class="parameter_description"><p>the request method to use</p></td> 604<td class="parameter_annotations"> </td> 605</tr> 606<tr> 607<td class="parameter_name"><p>uri</p></td> 608<td class="parameter_description"><p>the uri of the request. </p></td> 609<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 610</tr> 611</tbody> 612</table></div> 613</div> 614<div class="refsect3"> 615<a name="gst-rtsp-message-new-request.returns"></a><h4>Returns</h4> 616<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 617</div> 618</div> 619<hr> 620<div class="refsect2"> 621<a name="gst-rtsp-message-init-request"></a><h3>gst_rtsp_message_init_request ()</h3> 622<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 623gst_rtsp_message_init_request (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 624 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPMethod" title="enum GstRTSPMethod"><span class="type">GstRTSPMethod</span></a> method</code></em>, 625 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>);</pre> 626<p>Initialize <em class="parameter"><code>msg</code></em> 627 as a request message with <em class="parameter"><code>method</code></em> 628 and <em class="parameter"><code>uri</code></em> 629. To clear <em class="parameter"><code>msg</code></em> 630 631again, use <a class="link" href="GstRTSPMessage.html#gst-rtsp-message-unset" title="gst_rtsp_message_unset ()"><code class="function">gst_rtsp_message_unset()</code></a>.</p> 632<div class="refsect3"> 633<a name="gst-rtsp-message-init-request.parameters"></a><h4>Parameters</h4> 634<div class="informaltable"><table class="informaltable" width="100%" border="0"> 635<colgroup> 636<col width="150px" class="parameters_name"> 637<col class="parameters_description"> 638<col width="200px" class="parameters_annotations"> 639</colgroup> 640<tbody> 641<tr> 642<td class="parameter_name"><p>msg</p></td> 643<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 644<td class="parameter_annotations"> </td> 645</tr> 646<tr> 647<td class="parameter_name"><p>method</p></td> 648<td class="parameter_description"><p>the request method to use</p></td> 649<td class="parameter_annotations"> </td> 650</tr> 651<tr> 652<td class="parameter_name"><p>uri</p></td> 653<td class="parameter_description"><p>the uri of the request. </p></td> 654<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 655</tr> 656</tbody> 657</table></div> 658</div> 659<div class="refsect3"> 660<a name="gst-rtsp-message-init-request.returns"></a><h4>Returns</h4> 661<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 662</div> 663</div> 664<hr> 665<div class="refsect2"> 666<a name="gst-rtsp-message-parse-request"></a><h3>gst_rtsp_message_parse_request ()</h3> 667<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 668gst_rtsp_message_parse_request (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 669 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPMethod" title="enum GstRTSPMethod"><span class="type">GstRTSPMethod</span></a> *method</code></em>, 670 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **uri</code></em>, 671 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPVersion" title="enum GstRTSPVersion"><span class="type">GstRTSPVersion</span></a> *version</code></em>);</pre> 672<p>Parse the request message <em class="parameter"><code>msg</code></em> 673 and store the values <em class="parameter"><code>method</code></em> 674, <em class="parameter"><code>uri</code></em> 675 and 676<em class="parameter"><code>version</code></em> 677. The result locations can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if one is not interested in its 678value.</p> 679<p><em class="parameter"><code>uri</code></em> 680 remains valid for as long as <em class="parameter"><code>msg</code></em> 681 is valid and unchanged.</p> 682<div class="refsect3"> 683<a name="gst-rtsp-message-parse-request.parameters"></a><h4>Parameters</h4> 684<div class="informaltable"><table class="informaltable" width="100%" border="0"> 685<colgroup> 686<col width="150px" class="parameters_name"> 687<col class="parameters_description"> 688<col width="200px" class="parameters_annotations"> 689</colgroup> 690<tbody> 691<tr> 692<td class="parameter_name"><p>msg</p></td> 693<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 694<td class="parameter_annotations"> </td> 695</tr> 696<tr> 697<td class="parameter_name"><p>method</p></td> 698<td class="parameter_description"><p>location to hold the method. </p></td> 699<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> 700</tr> 701<tr> 702<td class="parameter_name"><p>uri</p></td> 703<td class="parameter_description"><p>location to hold the uri. </p></td> 704<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>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 705</tr> 706<tr> 707<td class="parameter_name"><p>version</p></td> 708<td class="parameter_description"><p>location to hold the version. </p></td> 709<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>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 710</tr> 711</tbody> 712</table></div> 713</div> 714<div class="refsect3"> 715<a name="gst-rtsp-message-parse-request.returns"></a><h4>Returns</h4> 716<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 717</div> 718</div> 719<hr> 720<div class="refsect2"> 721<a name="gst-rtsp-message-new-response"></a><h3>gst_rtsp_message_new_response ()</h3> 722<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 723gst_rtsp_message_new_response (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> **msg</code></em>, 724 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPStatusCode" title="enum GstRTSPStatusCode"><span class="type">GstRTSPStatusCode</span></a> code</code></em>, 725 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *reason</code></em>, 726 <em class="parameter"><code>const <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *request</code></em>);</pre> 727<p>Create a new response <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> with <em class="parameter"><code>code</code></em> 728 and <em class="parameter"><code>reason</code></em> 729 and store the 730result message in <em class="parameter"><code>msg</code></em> 731. Free with <a class="link" href="GstRTSPMessage.html#gst-rtsp-message-free" title="gst_rtsp_message_free ()"><code class="function">gst_rtsp_message_free()</code></a>.</p> 732<p>When <em class="parameter"><code>reason</code></em> 733 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the default reason for <em class="parameter"><code>code</code></em> 734 will be used.</p> 735<p>When <em class="parameter"><code>request</code></em> 736 is not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the relevant headers will be copied to the new 737response message.</p> 738<div class="refsect3"> 739<a name="gst-rtsp-message-new-response.parameters"></a><h4>Parameters</h4> 740<div class="informaltable"><table class="informaltable" width="100%" border="0"> 741<colgroup> 742<col width="150px" class="parameters_name"> 743<col class="parameters_description"> 744<col width="200px" class="parameters_annotations"> 745</colgroup> 746<tbody> 747<tr> 748<td class="parameter_name"><p>msg</p></td> 749<td class="parameter_description"><p>a location for the new <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a>. </p></td> 750<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> 751</tr> 752<tr> 753<td class="parameter_name"><p>code</p></td> 754<td class="parameter_description"><p>the status code</p></td> 755<td class="parameter_annotations"> </td> 756</tr> 757<tr> 758<td class="parameter_name"><p>reason</p></td> 759<td class="parameter_description"><p>the status reason or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 760<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 761</tr> 762<tr> 763<td class="parameter_name"><p>request</p></td> 764<td class="parameter_description"><p>the request that triggered the response or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 765<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 766</tr> 767</tbody> 768</table></div> 769</div> 770<div class="refsect3"> 771<a name="gst-rtsp-message-new-response.returns"></a><h4>Returns</h4> 772<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 773</div> 774</div> 775<hr> 776<div class="refsect2"> 777<a name="gst-rtsp-message-init-response"></a><h3>gst_rtsp_message_init_response ()</h3> 778<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 779gst_rtsp_message_init_response (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 780 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPStatusCode" title="enum GstRTSPStatusCode"><span class="type">GstRTSPStatusCode</span></a> code</code></em>, 781 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *reason</code></em>, 782 <em class="parameter"><code>const <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *request</code></em>);</pre> 783<p>Initialize <em class="parameter"><code>msg</code></em> 784 with <em class="parameter"><code>code</code></em> 785 and <em class="parameter"><code>reason</code></em> 786.</p> 787<p>When <em class="parameter"><code>reason</code></em> 788 is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the default reason for <em class="parameter"><code>code</code></em> 789 will be used.</p> 790<p>When <em class="parameter"><code>request</code></em> 791 is not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the relevant headers will be copied to the new 792response message.</p> 793<div class="refsect3"> 794<a name="gst-rtsp-message-init-response.parameters"></a><h4>Parameters</h4> 795<div class="informaltable"><table class="informaltable" width="100%" border="0"> 796<colgroup> 797<col width="150px" class="parameters_name"> 798<col class="parameters_description"> 799<col width="200px" class="parameters_annotations"> 800</colgroup> 801<tbody> 802<tr> 803<td class="parameter_name"><p>msg</p></td> 804<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 805<td class="parameter_annotations"> </td> 806</tr> 807<tr> 808<td class="parameter_name"><p>code</p></td> 809<td class="parameter_description"><p>the status code</p></td> 810<td class="parameter_annotations"> </td> 811</tr> 812<tr> 813<td class="parameter_name"><p>reason</p></td> 814<td class="parameter_description"><p>the status reason or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 815<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 816</tr> 817<tr> 818<td class="parameter_name"><p>request</p></td> 819<td class="parameter_description"><p>the request that triggered the response or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 820<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> 821</tr> 822</tbody> 823</table></div> 824</div> 825<div class="refsect3"> 826<a name="gst-rtsp-message-init-response.returns"></a><h4>Returns</h4> 827<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 828</div> 829</div> 830<hr> 831<div class="refsect2"> 832<a name="gst-rtsp-message-parse-response"></a><h3>gst_rtsp_message_parse_response ()</h3> 833<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 834gst_rtsp_message_parse_response (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 835 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPStatusCode" title="enum GstRTSPStatusCode"><span class="type">GstRTSPStatusCode</span></a> *code</code></em>, 836 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **reason</code></em>, 837 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPVersion" title="enum GstRTSPVersion"><span class="type">GstRTSPVersion</span></a> *version</code></em>);</pre> 838<p>Parse the response message <em class="parameter"><code>msg</code></em> 839 and store the values <em class="parameter"><code>code</code></em> 840, <em class="parameter"><code>reason</code></em> 841 and 842<em class="parameter"><code>version</code></em> 843. The result locations can be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if one is not interested in its 844value.</p> 845<p><em class="parameter"><code>reason</code></em> 846 remains valid for as long as <em class="parameter"><code>msg</code></em> 847 is valid and unchanged.</p> 848<div class="refsect3"> 849<a name="gst-rtsp-message-parse-response.parameters"></a><h4>Parameters</h4> 850<div class="informaltable"><table class="informaltable" width="100%" border="0"> 851<colgroup> 852<col width="150px" class="parameters_name"> 853<col class="parameters_description"> 854<col width="200px" class="parameters_annotations"> 855</colgroup> 856<tbody> 857<tr> 858<td class="parameter_name"><p>msg</p></td> 859<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 860<td class="parameter_annotations"> </td> 861</tr> 862<tr> 863<td class="parameter_name"><p>code</p></td> 864<td class="parameter_description"><p>location to hold the status code. </p></td> 865<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> 866</tr> 867<tr> 868<td class="parameter_name"><p>reason</p></td> 869<td class="parameter_description"><p>location to hold the status reason. </p></td> 870<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>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 871</tr> 872<tr> 873<td class="parameter_name"><p>version</p></td> 874<td class="parameter_description"><p>location to hold the version. </p></td> 875<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>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 876</tr> 877</tbody> 878</table></div> 879</div> 880<div class="refsect3"> 881<a name="gst-rtsp-message-parse-response.returns"></a><h4>Returns</h4> 882<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 883</div> 884</div> 885<hr> 886<div class="refsect2"> 887<a name="gst-rtsp-message-new-data"></a><h3>gst_rtsp_message_new_data ()</h3> 888<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 889gst_rtsp_message_new_data (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> **msg</code></em>, 890 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> channel</code></em>);</pre> 891<p>Create a new data <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> with <em class="parameter"><code>channel</code></em> 892 and store the 893result message in <em class="parameter"><code>msg</code></em> 894. Free with <a class="link" href="GstRTSPMessage.html#gst-rtsp-message-free" title="gst_rtsp_message_free ()"><code class="function">gst_rtsp_message_free()</code></a>.</p> 895<div class="refsect3"> 896<a name="gst-rtsp-message-new-data.parameters"></a><h4>Parameters</h4> 897<div class="informaltable"><table class="informaltable" width="100%" border="0"> 898<colgroup> 899<col width="150px" class="parameters_name"> 900<col class="parameters_description"> 901<col width="200px" class="parameters_annotations"> 902</colgroup> 903<tbody> 904<tr> 905<td class="parameter_name"><p>msg</p></td> 906<td class="parameter_description"><p>a location for the new <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a>. </p></td> 907<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> 908</tr> 909<tr> 910<td class="parameter_name"><p>channel</p></td> 911<td class="parameter_description"><p>the channel</p></td> 912<td class="parameter_annotations"> </td> 913</tr> 914</tbody> 915</table></div> 916</div> 917<div class="refsect3"> 918<a name="gst-rtsp-message-new-data.returns"></a><h4>Returns</h4> 919<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 920</div> 921</div> 922<hr> 923<div class="refsect2"> 924<a name="gst-rtsp-message-init-data"></a><h3>gst_rtsp_message_init_data ()</h3> 925<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 926gst_rtsp_message_init_data (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 927 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> channel</code></em>);</pre> 928<p>Initialize a new data <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> for <em class="parameter"><code>channel</code></em> 929.</p> 930<div class="refsect3"> 931<a name="gst-rtsp-message-init-data.parameters"></a><h4>Parameters</h4> 932<div class="informaltable"><table class="informaltable" width="100%" border="0"> 933<colgroup> 934<col width="150px" class="parameters_name"> 935<col class="parameters_description"> 936<col width="200px" class="parameters_annotations"> 937</colgroup> 938<tbody> 939<tr> 940<td class="parameter_name"><p>msg</p></td> 941<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 942<td class="parameter_annotations"> </td> 943</tr> 944<tr> 945<td class="parameter_name"><p>channel</p></td> 946<td class="parameter_description"><p>a channel</p></td> 947<td class="parameter_annotations"> </td> 948</tr> 949</tbody> 950</table></div> 951</div> 952<div class="refsect3"> 953<a name="gst-rtsp-message-init-data.returns"></a><h4>Returns</h4> 954<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 955</div> 956</div> 957<hr> 958<div class="refsect2"> 959<a name="gst-rtsp-message-parse-data"></a><h3>gst_rtsp_message_parse_data ()</h3> 960<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 961gst_rtsp_message_parse_data (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 962 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *channel</code></em>);</pre> 963<p>Parse the data message <em class="parameter"><code>msg</code></em> 964 and store the channel in <em class="parameter"><code>channel</code></em> 965.</p> 966<div class="refsect3"> 967<a name="gst-rtsp-message-parse-data.parameters"></a><h4>Parameters</h4> 968<div class="informaltable"><table class="informaltable" width="100%" border="0"> 969<colgroup> 970<col width="150px" class="parameters_name"> 971<col class="parameters_description"> 972<col width="200px" class="parameters_annotations"> 973</colgroup> 974<tbody> 975<tr> 976<td class="parameter_name"><p>msg</p></td> 977<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 978<td class="parameter_annotations"> </td> 979</tr> 980<tr> 981<td class="parameter_name"><p>channel</p></td> 982<td class="parameter_description"><p>location to hold the channel. </p></td> 983<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> 984</tr> 985</tbody> 986</table></div> 987</div> 988<div class="refsect3"> 989<a name="gst-rtsp-message-parse-data.returns"></a><h4>Returns</h4> 990<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 991</div> 992</div> 993<hr> 994<div class="refsect2"> 995<a name="gst-rtsp-message-add-header"></a><h3>gst_rtsp_message_add_header ()</h3> 996<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 997gst_rtsp_message_add_header (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 998 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a> field</code></em>, 999 <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> 1000<p>Add a header with key <em class="parameter"><code>field</code></em> 1001 and <em class="parameter"><code>value</code></em> 1002 to <em class="parameter"><code>msg</code></em> 1003. This function takes a copy 1004of <em class="parameter"><code>value</code></em> 1005.</p> 1006<div class="refsect3"> 1007<a name="gst-rtsp-message-add-header.parameters"></a><h4>Parameters</h4> 1008<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1009<colgroup> 1010<col width="150px" class="parameters_name"> 1011<col class="parameters_description"> 1012<col width="200px" class="parameters_annotations"> 1013</colgroup> 1014<tbody> 1015<tr> 1016<td class="parameter_name"><p>msg</p></td> 1017<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1018<td class="parameter_annotations"> </td> 1019</tr> 1020<tr> 1021<td class="parameter_name"><p>field</p></td> 1022<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a></p></td> 1023<td class="parameter_annotations"> </td> 1024</tr> 1025<tr> 1026<td class="parameter_name"><p>value</p></td> 1027<td class="parameter_description"><p>the value of the header. </p></td> 1028<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1029</tr> 1030</tbody> 1031</table></div> 1032</div> 1033<div class="refsect3"> 1034<a name="gst-rtsp-message-add-header.returns"></a><h4>Returns</h4> 1035<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 1036</div> 1037</div> 1038<hr> 1039<div class="refsect2"> 1040<a name="gst-rtsp-message-take-header"></a><h3>gst_rtsp_message_take_header ()</h3> 1041<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1042gst_rtsp_message_take_header (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1043 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a> field</code></em>, 1044 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre> 1045<p>Add a header with key <em class="parameter"><code>field</code></em> 1046 and <em class="parameter"><code>value</code></em> 1047 to <em class="parameter"><code>msg</code></em> 1048. This function takes 1049ownership of <em class="parameter"><code>value</code></em> 1050.</p> 1051<div class="refsect3"> 1052<a name="gst-rtsp-message-take-header.parameters"></a><h4>Parameters</h4> 1053<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1054<colgroup> 1055<col width="150px" class="parameters_name"> 1056<col class="parameters_description"> 1057<col width="200px" class="parameters_annotations"> 1058</colgroup> 1059<tbody> 1060<tr> 1061<td class="parameter_name"><p>msg</p></td> 1062<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1063<td class="parameter_annotations"> </td> 1064</tr> 1065<tr> 1066<td class="parameter_name"><p>field</p></td> 1067<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a></p></td> 1068<td class="parameter_annotations"> </td> 1069</tr> 1070<tr> 1071<td class="parameter_name"><p>value</p></td> 1072<td class="parameter_description"><p>the value of the header. </p></td> 1073<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td> 1074</tr> 1075</tbody> 1076</table></div> 1077</div> 1078<div class="refsect3"> 1079<a name="gst-rtsp-message-take-header.returns"></a><h4>Returns</h4> 1080<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 1081</div> 1082</div> 1083<hr> 1084<div class="refsect2"> 1085<a name="gst-rtsp-message-remove-header"></a><h3>gst_rtsp_message_remove_header ()</h3> 1086<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1087gst_rtsp_message_remove_header (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1088 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a> field</code></em>, 1089 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> indx</code></em>);</pre> 1090<p>Remove the <em class="parameter"><code>indx</code></em> 1091 header with key <em class="parameter"><code>field</code></em> 1092 from <em class="parameter"><code>msg</code></em> 1093. If <em class="parameter"><code>indx</code></em> 1094 equals -1, all 1095headers will be removed.</p> 1096<div class="refsect3"> 1097<a name="gst-rtsp-message-remove-header.parameters"></a><h4>Parameters</h4> 1098<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1099<colgroup> 1100<col width="150px" class="parameters_name"> 1101<col class="parameters_description"> 1102<col width="200px" class="parameters_annotations"> 1103</colgroup> 1104<tbody> 1105<tr> 1106<td class="parameter_name"><p>msg</p></td> 1107<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1108<td class="parameter_annotations"> </td> 1109</tr> 1110<tr> 1111<td class="parameter_name"><p>field</p></td> 1112<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a></p></td> 1113<td class="parameter_annotations"> </td> 1114</tr> 1115<tr> 1116<td class="parameter_name"><p>indx</p></td> 1117<td class="parameter_description"><p>the index of the header</p></td> 1118<td class="parameter_annotations"> </td> 1119</tr> 1120</tbody> 1121</table></div> 1122</div> 1123<div class="refsect3"> 1124<a name="gst-rtsp-message-remove-header.returns"></a><h4>Returns</h4> 1125<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 1126</div> 1127</div> 1128<hr> 1129<div class="refsect2"> 1130<a name="gst-rtsp-message-get-header"></a><h3>gst_rtsp_message_get_header ()</h3> 1131<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1132gst_rtsp_message_get_header (<em class="parameter"><code>const <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1133 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a> field</code></em>, 1134 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>, 1135 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> indx</code></em>);</pre> 1136<p>Get the <em class="parameter"><code>indx</code></em> 1137 header value with key <em class="parameter"><code>field</code></em> 1138 from <em class="parameter"><code>msg</code></em> 1139. The result in <em class="parameter"><code>value</code></em> 1140 1141stays valid as long as it remains present in <em class="parameter"><code>msg</code></em> 1142.</p> 1143<div class="refsect3"> 1144<a name="gst-rtsp-message-get-header.parameters"></a><h4>Parameters</h4> 1145<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1146<colgroup> 1147<col width="150px" class="parameters_name"> 1148<col class="parameters_description"> 1149<col width="200px" class="parameters_annotations"> 1150</colgroup> 1151<tbody> 1152<tr> 1153<td class="parameter_name"><p>msg</p></td> 1154<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1155<td class="parameter_annotations"> </td> 1156</tr> 1157<tr> 1158<td class="parameter_name"><p>field</p></td> 1159<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a></p></td> 1160<td class="parameter_annotations"> </td> 1161</tr> 1162<tr> 1163<td class="parameter_name"><p>value</p></td> 1164<td class="parameter_description"><p>pointer to hold the result. </p></td> 1165<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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1166</tr> 1167<tr> 1168<td class="parameter_name"><p>indx</p></td> 1169<td class="parameter_description"><p>the index of the header</p></td> 1170<td class="parameter_annotations"> </td> 1171</tr> 1172</tbody> 1173</table></div> 1174</div> 1175<div class="refsect3"> 1176<a name="gst-rtsp-message-get-header.returns"></a><h4>Returns</h4> 1177<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>field</code></em> 1178was found, <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-ENOTIMPL:CAPS"><span class="type">GST_RTSP_ENOTIMPL</span></a> if the key 1179was not found.</p> 1180</div> 1181</div> 1182<hr> 1183<div class="refsect2"> 1184<a name="gst-rtsp-message-add-header-by-name"></a><h3>gst_rtsp_message_add_header_by_name ()</h3> 1185<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1186gst_rtsp_message_add_header_by_name (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1187 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *header</code></em>, 1188 <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> 1189<p>Add a header with key <em class="parameter"><code>header</code></em> 1190 and <em class="parameter"><code>value</code></em> 1191 to <em class="parameter"><code>msg</code></em> 1192. This function takes a copy 1193of <em class="parameter"><code>value</code></em> 1194.</p> 1195<div class="refsect3"> 1196<a name="gst-rtsp-message-add-header-by-name.parameters"></a><h4>Parameters</h4> 1197<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1198<colgroup> 1199<col width="150px" class="parameters_name"> 1200<col class="parameters_description"> 1201<col width="200px" class="parameters_annotations"> 1202</colgroup> 1203<tbody> 1204<tr> 1205<td class="parameter_name"><p>msg</p></td> 1206<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1207<td class="parameter_annotations"> </td> 1208</tr> 1209<tr> 1210<td class="parameter_name"><p>header</p></td> 1211<td class="parameter_description"><p>header string. </p></td> 1212<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1213</tr> 1214<tr> 1215<td class="parameter_name"><p>value</p></td> 1216<td class="parameter_description"><p>the value of the header. </p></td> 1217<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1218</tr> 1219</tbody> 1220</table></div> 1221</div> 1222<div class="refsect3"> 1223<a name="gst-rtsp-message-add-header-by-name.returns"></a><h4>Returns</h4> 1224<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 1225</div> 1226<p class="since">Since: <a class="link" href="ix10.html#api-index-1.6">1.6</a></p> 1227</div> 1228<hr> 1229<div class="refsect2"> 1230<a name="gst-rtsp-message-take-header-by-name"></a><h3>gst_rtsp_message_take_header_by_name ()</h3> 1231<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1232gst_rtsp_message_take_header_by_name (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1233 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *header</code></em>, 1234 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre> 1235<p>Add a header with key <em class="parameter"><code>header</code></em> 1236 and <em class="parameter"><code>value</code></em> 1237 to <em class="parameter"><code>msg</code></em> 1238. This function takes 1239ownership of <em class="parameter"><code>value</code></em> 1240, but not of <em class="parameter"><code>header</code></em> 1241.</p> 1242<div class="refsect3"> 1243<a name="gst-rtsp-message-take-header-by-name.parameters"></a><h4>Parameters</h4> 1244<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1245<colgroup> 1246<col width="150px" class="parameters_name"> 1247<col class="parameters_description"> 1248<col width="200px" class="parameters_annotations"> 1249</colgroup> 1250<tbody> 1251<tr> 1252<td class="parameter_name"><p>msg</p></td> 1253<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1254<td class="parameter_annotations"> </td> 1255</tr> 1256<tr> 1257<td class="parameter_name"><p>header</p></td> 1258<td class="parameter_description"><p>a header string. </p></td> 1259<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1260</tr> 1261<tr> 1262<td class="parameter_name"><p>value</p></td> 1263<td class="parameter_description"><p>the value of the header. </p></td> 1264<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td> 1265</tr> 1266</tbody> 1267</table></div> 1268</div> 1269<div class="refsect3"> 1270<a name="gst-rtsp-message-take-header-by-name.returns"></a><h4>Returns</h4> 1271<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a>.</p> 1272</div> 1273<p class="since">Since: <a class="link" href="ix10.html#api-index-1.6">1.6</a></p> 1274</div> 1275<hr> 1276<div class="refsect2"> 1277<a name="gst-rtsp-message-remove-header-by-name"></a><h3>gst_rtsp_message_remove_header_by_name ()</h3> 1278<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1279gst_rtsp_message_remove_header_by_name 1280 (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1281 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *header</code></em>, 1282 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index</code></em>);</pre> 1283<p>Remove the <em class="parameter"><code>index</code></em> 1284 header with key <em class="parameter"><code>header</code></em> 1285 from <em class="parameter"><code>msg</code></em> 1286. If <em class="parameter"><code>index</code></em> 1287 equals -1, 1288all matching headers will be removed.</p> 1289<div class="refsect3"> 1290<a name="gst-rtsp-message-remove-header-by-name.parameters"></a><h4>Parameters</h4> 1291<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1292<colgroup> 1293<col width="150px" class="parameters_name"> 1294<col class="parameters_description"> 1295<col width="200px" class="parameters_annotations"> 1296</colgroup> 1297<tbody> 1298<tr> 1299<td class="parameter_name"><p>msg</p></td> 1300<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1301<td class="parameter_annotations"> </td> 1302</tr> 1303<tr> 1304<td class="parameter_name"><p>header</p></td> 1305<td class="parameter_description"><p>the header string</p></td> 1306<td class="parameter_annotations"> </td> 1307</tr> 1308<tr> 1309<td class="parameter_name"><p>index</p></td> 1310<td class="parameter_description"><p>the index of the header</p></td> 1311<td class="parameter_annotations"> </td> 1312</tr> 1313</tbody> 1314</table></div> 1315</div> 1316<div class="refsect3"> 1317<a name="gst-rtsp-message-remove-header-by-name.returns"></a><h4>Returns</h4> 1318<p> a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="type">GstRTSPResult</span></a></p> 1319</div> 1320<p class="since">Since: <a class="link" href="ix10.html#api-index-1.6">1.6</a></p> 1321</div> 1322<hr> 1323<div class="refsect2"> 1324<a name="gst-rtsp-message-get-header-by-name"></a><h3>gst_rtsp_message_get_header_by_name ()</h3> 1325<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1326gst_rtsp_message_get_header_by_name (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1327 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *header</code></em>, 1328 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>, 1329 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index</code></em>);</pre> 1330<p>Get the <em class="parameter"><code>index</code></em> 1331 header value with key <em class="parameter"><code>header</code></em> 1332 from <em class="parameter"><code>msg</code></em> 1333. The result in <em class="parameter"><code>value</code></em> 1334 1335stays valid as long as it remains present in <em class="parameter"><code>msg</code></em> 1336.</p> 1337<div class="refsect3"> 1338<a name="gst-rtsp-message-get-header-by-name.parameters"></a><h4>Parameters</h4> 1339<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1340<colgroup> 1341<col width="150px" class="parameters_name"> 1342<col class="parameters_description"> 1343<col width="200px" class="parameters_annotations"> 1344</colgroup> 1345<tbody> 1346<tr> 1347<td class="parameter_name"><p>msg</p></td> 1348<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1349<td class="parameter_annotations"> </td> 1350</tr> 1351<tr> 1352<td class="parameter_name"><p>header</p></td> 1353<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a></p></td> 1354<td class="parameter_annotations"> </td> 1355</tr> 1356<tr> 1357<td class="parameter_name"><p>value</p></td> 1358<td class="parameter_description"><p>pointer to hold the result. </p></td> 1359<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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1360</tr> 1361<tr> 1362<td class="parameter_name"><p>index</p></td> 1363<td class="parameter_description"><p>the index of the header</p></td> 1364<td class="parameter_annotations"> </td> 1365</tr> 1366</tbody> 1367</table></div> 1368</div> 1369<div class="refsect3"> 1370<a name="gst-rtsp-message-get-header-by-name.returns"></a><h4>Returns</h4> 1371<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>field</code></em> 1372was found, <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-ENOTIMPL:CAPS"><span class="type">GST_RTSP_ENOTIMPL</span></a> if the key 1373was not found.</p> 1374</div> 1375<p class="since">Since: <a class="link" href="ix10.html#api-index-1.6">1.6</a></p> 1376</div> 1377<hr> 1378<div class="refsect2"> 1379<a name="gst-rtsp-message-append-headers"></a><h3>gst_rtsp_message_append_headers ()</h3> 1380<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1381gst_rtsp_message_append_headers (<em class="parameter"><code>const <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1382 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="type">GString</span></a> *str</code></em>);</pre> 1383<p>Append the currently configured headers in <em class="parameter"><code>msg</code></em> 1384 to the <a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="type">GString</span></a> <em class="parameter"><code>str</code></em> 1385 suitable 1386for transmission.</p> 1387<div class="refsect3"> 1388<a name="gst-rtsp-message-append-headers.parameters"></a><h4>Parameters</h4> 1389<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1390<colgroup> 1391<col width="150px" class="parameters_name"> 1392<col class="parameters_description"> 1393<col width="200px" class="parameters_annotations"> 1394</colgroup> 1395<tbody> 1396<tr> 1397<td class="parameter_name"><p>msg</p></td> 1398<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1399<td class="parameter_annotations"> </td> 1400</tr> 1401<tr> 1402<td class="parameter_name"><p>str</p></td> 1403<td class="parameter_description"><p>a string. </p></td> 1404<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1405</tr> 1406</tbody> 1407</table></div> 1408</div> 1409<div class="refsect3"> 1410<a name="gst-rtsp-message-append-headers.returns"></a><h4>Returns</h4> 1411<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1412</div> 1413</div> 1414<hr> 1415<div class="refsect2"> 1416<a name="gst-rtsp-message-set-body"></a><h3>gst_rtsp_message_set_body ()</h3> 1417<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1418gst_rtsp_message_set_body (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1419 <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>, 1420 <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>);</pre> 1421<p>Set the body of <em class="parameter"><code>msg</code></em> 1422 to a copy of <em class="parameter"><code>data</code></em> 1423. Any existing body or body buffer 1424will be replaced by the new body.</p> 1425<div class="refsect3"> 1426<a name="gst-rtsp-message-set-body.parameters"></a><h4>Parameters</h4> 1427<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1428<colgroup> 1429<col width="150px" class="parameters_name"> 1430<col class="parameters_description"> 1431<col width="200px" class="parameters_annotations"> 1432</colgroup> 1433<tbody> 1434<tr> 1435<td class="parameter_name"><p>msg</p></td> 1436<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1437<td class="parameter_annotations"> </td> 1438</tr> 1439<tr> 1440<td class="parameter_name"><p>data</p></td> 1441<td class="parameter_description"><p>the data. </p></td> 1442<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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1443</tr> 1444<tr> 1445<td class="parameter_name"><p>size</p></td> 1446<td class="parameter_description"><p>the size of <em class="parameter"><code>data</code></em> 1447</p></td> 1448<td class="parameter_annotations"> </td> 1449</tr> 1450</tbody> 1451</table></div> 1452</div> 1453<div class="refsect3"> 1454<a name="gst-rtsp-message-set-body.returns"></a><h4>Returns</h4> 1455<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1456</div> 1457</div> 1458<hr> 1459<div class="refsect2"> 1460<a name="gst-rtsp-message-take-body"></a><h3>gst_rtsp_message_take_body ()</h3> 1461<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1462gst_rtsp_message_take_body (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1463 <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>, 1464 <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>);</pre> 1465<p>Set the body of <em class="parameter"><code>msg</code></em> 1466 to <em class="parameter"><code>data</code></em> 1467 and <em class="parameter"><code>size</code></em> 1468. This method takes ownership of 1469<em class="parameter"><code>data</code></em> 1470. Any existing body or body buffer will be replaced by the new body.</p> 1471<div class="refsect3"> 1472<a name="gst-rtsp-message-take-body.parameters"></a><h4>Parameters</h4> 1473<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1474<colgroup> 1475<col width="150px" class="parameters_name"> 1476<col class="parameters_description"> 1477<col width="200px" class="parameters_annotations"> 1478</colgroup> 1479<tbody> 1480<tr> 1481<td class="parameter_name"><p>msg</p></td> 1482<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1483<td class="parameter_annotations"> </td> 1484</tr> 1485<tr> 1486<td class="parameter_name"><p>data</p></td> 1487<td class="parameter_description"><p>the data. </p></td> 1488<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> 1489</tr> 1490<tr> 1491<td class="parameter_name"><p>size</p></td> 1492<td class="parameter_description"><p>the size of <em class="parameter"><code>data</code></em> 1493</p></td> 1494<td class="parameter_annotations"> </td> 1495</tr> 1496</tbody> 1497</table></div> 1498</div> 1499<div class="refsect3"> 1500<a name="gst-rtsp-message-take-body.returns"></a><h4>Returns</h4> 1501<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1502</div> 1503</div> 1504<hr> 1505<div class="refsect2"> 1506<a name="gst-rtsp-message-get-body"></a><h3>gst_rtsp_message_get_body ()</h3> 1507<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1508gst_rtsp_message_get_body (<em class="parameter"><code>const <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1509 <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>, 1510 <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>);</pre> 1511<p>Get the body of <em class="parameter"><code>msg</code></em> 1512. <em class="parameter"><code>data</code></em> 1513 remains valid for as long as <em class="parameter"><code>msg</code></em> 1514 is valid and 1515unchanged.</p> 1516<p>If the message body was set as a <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a> before this will cause the data 1517to be copied and stored in the message. The <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a> will no longer be 1518kept in the message.</p> 1519<div class="refsect3"> 1520<a name="gst-rtsp-message-get-body.parameters"></a><h4>Parameters</h4> 1521<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1522<colgroup> 1523<col width="150px" class="parameters_name"> 1524<col class="parameters_description"> 1525<col width="200px" class="parameters_annotations"> 1526</colgroup> 1527<tbody> 1528<tr> 1529<td class="parameter_name"><p>msg</p></td> 1530<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1531<td class="parameter_annotations"> </td> 1532</tr> 1533<tr> 1534<td class="parameter_name"><p>data</p></td> 1535<td class="parameter_description"><p>location for the data. </p></td> 1536<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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=size]</span></td> 1537</tr> 1538<tr> 1539<td class="parameter_name"><p>size</p></td> 1540<td class="parameter_description"><p>location for the size of <em class="parameter"><code>data</code></em> 1541. </p></td> 1542<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> 1543</tr> 1544</tbody> 1545</table></div> 1546</div> 1547<div class="refsect3"> 1548<a name="gst-rtsp-message-get-body.returns"></a><h4>Returns</h4> 1549<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1550</div> 1551</div> 1552<hr> 1553<div class="refsect2"> 1554<a name="gst-rtsp-message-steal-body"></a><h3>gst_rtsp_message_steal_body ()</h3> 1555<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1556gst_rtsp_message_steal_body (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1557 <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>, 1558 <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>);</pre> 1559<p>Take the body of <em class="parameter"><code>msg</code></em> 1560 and store it in <em class="parameter"><code>data</code></em> 1561 and <em class="parameter"><code>size</code></em> 1562. After this method, 1563the body and size of <em class="parameter"><code>msg</code></em> 1564 will be set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and 0 respectively.</p> 1565<div class="refsect3"> 1566<a name="gst-rtsp-message-steal-body.parameters"></a><h4>Parameters</h4> 1567<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1568<colgroup> 1569<col width="150px" class="parameters_name"> 1570<col class="parameters_description"> 1571<col width="200px" class="parameters_annotations"> 1572</colgroup> 1573<tbody> 1574<tr> 1575<td class="parameter_name"><p>msg</p></td> 1576<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1577<td class="parameter_annotations"> </td> 1578</tr> 1579<tr> 1580<td class="parameter_name"><p>data</p></td> 1581<td class="parameter_description"><p>location for the data. </p></td> 1582<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>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=size]</span></td> 1583</tr> 1584<tr> 1585<td class="parameter_name"><p>size</p></td> 1586<td class="parameter_description"><p>location for the size of <em class="parameter"><code>data</code></em> 1587. </p></td> 1588<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td> 1589</tr> 1590</tbody> 1591</table></div> 1592</div> 1593<div class="refsect3"> 1594<a name="gst-rtsp-message-steal-body.returns"></a><h4>Returns</h4> 1595<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1596</div> 1597</div> 1598<hr> 1599<div class="refsect2"> 1600<a name="gst-rtsp-message-set-body-buffer"></a><h3>gst_rtsp_message_set_body_buffer ()</h3> 1601<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1602gst_rtsp_message_set_body_buffer (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1603 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a> *buffer</code></em>);</pre> 1604<p>Set the body of <em class="parameter"><code>msg</code></em> 1605 to <em class="parameter"><code>buffer</code></em> 1606. Any existing body or body buffer 1607will be replaced by the new body.</p> 1608<div class="refsect3"> 1609<a name="gst-rtsp-message-set-body-buffer.parameters"></a><h4>Parameters</h4> 1610<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1611<colgroup> 1612<col width="150px" class="parameters_name"> 1613<col class="parameters_description"> 1614<col width="200px" class="parameters_annotations"> 1615</colgroup> 1616<tbody> 1617<tr> 1618<td class="parameter_name"><p>msg</p></td> 1619<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1620<td class="parameter_annotations"> </td> 1621</tr> 1622<tr> 1623<td class="parameter_name"><p>buffer</p></td> 1624<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a></p></td> 1625<td class="parameter_annotations"> </td> 1626</tr> 1627</tbody> 1628</table></div> 1629</div> 1630<div class="refsect3"> 1631<a name="gst-rtsp-message-set-body-buffer.returns"></a><h4>Returns</h4> 1632<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1633</div> 1634<p class="since">Since: <a class="link" href="ix03.html#api-index-1.16">1.16</a></p> 1635</div> 1636<hr> 1637<div class="refsect2"> 1638<a name="gst-rtsp-message-take-body-buffer"></a><h3>gst_rtsp_message_take_body_buffer ()</h3> 1639<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1640gst_rtsp_message_take_body_buffer (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1641 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a> *buffer</code></em>);</pre> 1642<p>Set the body of <em class="parameter"><code>msg</code></em> 1643 to <em class="parameter"><code>buffer</code></em> 1644. This method takes ownership of <em class="parameter"><code>buffer</code></em> 1645. 1646Any existing body or body buffer will be replaced by the new body.</p> 1647<div class="refsect3"> 1648<a name="gst-rtsp-message-take-body-buffer.parameters"></a><h4>Parameters</h4> 1649<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1650<colgroup> 1651<col width="150px" class="parameters_name"> 1652<col class="parameters_description"> 1653<col width="200px" class="parameters_annotations"> 1654</colgroup> 1655<tbody> 1656<tr> 1657<td class="parameter_name"><p>msg</p></td> 1658<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1659<td class="parameter_annotations"> </td> 1660</tr> 1661<tr> 1662<td class="parameter_name"><p>buffer</p></td> 1663<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a>. </p></td> 1664<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td> 1665</tr> 1666</tbody> 1667</table></div> 1668</div> 1669<div class="refsect3"> 1670<a name="gst-rtsp-message-take-body-buffer.returns"></a><h4>Returns</h4> 1671<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1672</div> 1673<p class="since">Since: <a class="link" href="ix03.html#api-index-1.16">1.16</a></p> 1674</div> 1675<hr> 1676<div class="refsect2"> 1677<a name="gst-rtsp-message-has-body-buffer"></a><h3>gst_rtsp_message_has_body_buffer ()</h3> 1678<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 1679gst_rtsp_message_has_body_buffer (<em class="parameter"><code>const <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>);</pre> 1680<p>Checks if <em class="parameter"><code>msg</code></em> 1681 has a body and the body is stored as <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a>.</p> 1682<div class="refsect3"> 1683<a name="gst-rtsp-message-has-body-buffer.parameters"></a><h4>Parameters</h4> 1684<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1685<colgroup> 1686<col width="150px" class="parameters_name"> 1687<col class="parameters_description"> 1688<col width="200px" class="parameters_annotations"> 1689</colgroup> 1690<tbody><tr> 1691<td class="parameter_name"><p>msg</p></td> 1692<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1693<td class="parameter_annotations"> </td> 1694</tr></tbody> 1695</table></div> 1696</div> 1697<div class="refsect3"> 1698<a name="gst-rtsp-message-has-body-buffer.returns"></a><h4>Returns</h4> 1699<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>msg</code></em> 1700has a body and it's stored as <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a>, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 1701otherwise.</p> 1702</div> 1703<p class="since">Since: <a class="link" href="ix03.html#api-index-1.16">1.16</a></p> 1704</div> 1705<hr> 1706<div class="refsect2"> 1707<a name="gst-rtsp-message-get-body-buffer"></a><h3>gst_rtsp_message_get_body_buffer ()</h3> 1708<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1709gst_rtsp_message_get_body_buffer (<em class="parameter"><code>const <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1710 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a> **buffer</code></em>);</pre> 1711<p>Get the body of <em class="parameter"><code>msg</code></em> 1712. <em class="parameter"><code>buffer</code></em> 1713 remains valid for as long as <em class="parameter"><code>msg</code></em> 1714 is valid and 1715unchanged.</p> 1716<p>If body data was set from raw memory instead of a <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a> this function 1717will always return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The caller can check if there is a body buffer by 1718calling <a class="link" href="GstRTSPMessage.html#gst-rtsp-message-has-body-buffer" title="gst_rtsp_message_has_body_buffer ()"><code class="function">gst_rtsp_message_has_body_buffer()</code></a>.</p> 1719<div class="refsect3"> 1720<a name="gst-rtsp-message-get-body-buffer.parameters"></a><h4>Parameters</h4> 1721<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1722<colgroup> 1723<col width="150px" class="parameters_name"> 1724<col class="parameters_description"> 1725<col width="200px" class="parameters_annotations"> 1726</colgroup> 1727<tbody> 1728<tr> 1729<td class="parameter_name"><p>msg</p></td> 1730<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1731<td class="parameter_annotations"> </td> 1732</tr> 1733<tr> 1734<td class="parameter_name"><p>buffer</p></td> 1735<td class="parameter_description"><p>location for the buffer. </p></td> 1736<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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td> 1737</tr> 1738</tbody> 1739</table></div> 1740</div> 1741<div class="refsect3"> 1742<a name="gst-rtsp-message-get-body-buffer.returns"></a><h4>Returns</h4> 1743<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1744</div> 1745<p class="since">Since: <a class="link" href="ix03.html#api-index-1.16">1.16</a></p> 1746</div> 1747<hr> 1748<div class="refsect2"> 1749<a name="gst-rtsp-message-steal-body-buffer"></a><h3>gst_rtsp_message_steal_body_buffer ()</h3> 1750<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1751gst_rtsp_message_steal_body_buffer (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1752 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a> **buffer</code></em>);</pre> 1753<p>Take the body of <em class="parameter"><code>msg</code></em> 1754 and store it in <em class="parameter"><code>buffer</code></em> 1755. After this method, 1756the body and size of <em class="parameter"><code>msg</code></em> 1757 will be set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and 0 respectively.</p> 1758<p>If body data was set from raw memory instead of a <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBuffer.html#GstBuffer-struct"><span class="type">GstBuffer</span></a> this function 1759will always return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The caller can check if there is a body buffer by 1760calling <a class="link" href="GstRTSPMessage.html#gst-rtsp-message-has-body-buffer" title="gst_rtsp_message_has_body_buffer ()"><code class="function">gst_rtsp_message_has_body_buffer()</code></a>.</p> 1761<div class="refsect3"> 1762<a name="gst-rtsp-message-steal-body-buffer.parameters"></a><h4>Parameters</h4> 1763<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1764<colgroup> 1765<col width="150px" class="parameters_name"> 1766<col class="parameters_description"> 1767<col width="200px" class="parameters_annotations"> 1768</colgroup> 1769<tbody> 1770<tr> 1771<td class="parameter_name"><p>msg</p></td> 1772<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1773<td class="parameter_annotations"> </td> 1774</tr> 1775<tr> 1776<td class="parameter_name"><p>buffer</p></td> 1777<td class="parameter_description"><p>location for the buffer. </p></td> 1778<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> 1779</tr> 1780</tbody> 1781</table></div> 1782</div> 1783<div class="refsect3"> 1784<a name="gst-rtsp-message-steal-body-buffer.returns"></a><h4>Returns</h4> 1785<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1786</div> 1787<p class="since">Since: <a class="link" href="ix03.html#api-index-1.16">1.16</a></p> 1788</div> 1789<hr> 1790<div class="refsect2"> 1791<a name="gst-rtsp-message-parse-auth-credentials"></a><h3>gst_rtsp_message_parse_auth_credentials ()</h3> 1792<pre class="programlisting"><a class="link" href="GstRTSPMessage.html#GstRTSPAuthCredential"><span class="returnvalue">GstRTSPAuthCredential</span></a> ** 1793gst_rtsp_message_parse_auth_credentials 1794 (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>, 1795 <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a> field</code></em>);</pre> 1796<p>Parses the credentials given in a WWW-Authenticate or Authorization header.</p> 1797<div class="refsect3"> 1798<a name="gst-rtsp-message-parse-auth-credentials.parameters"></a><h4>Parameters</h4> 1799<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1800<colgroup> 1801<col width="150px" class="parameters_name"> 1802<col class="parameters_description"> 1803<col width="200px" class="parameters_annotations"> 1804</colgroup> 1805<tbody> 1806<tr> 1807<td class="parameter_name"><p>msg</p></td> 1808<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1809<td class="parameter_annotations"> </td> 1810</tr> 1811<tr> 1812<td class="parameter_name"><p>field</p></td> 1813<td class="parameter_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPHeaderField" title="enum GstRTSPHeaderField"><span class="type">GstRTSPHeaderField</span></a></p></td> 1814<td class="parameter_annotations"> </td> 1815</tr> 1816</tbody> 1817</table></div> 1818</div> 1819<div class="refsect3"> 1820<a name="gst-rtsp-message-parse-auth-credentials.returns"></a><h4>Returns</h4> 1821<p><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of GstRTSPAuthCredential or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p> 1822<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></p> 1823</div> 1824<p class="since">Since: <a class="link" href="ix05.html#api-index-1.12">1.12</a></p> 1825</div> 1826<hr> 1827<div class="refsect2"> 1828<a name="gst-rtsp-auth-credentials-free"></a><h3>gst_rtsp_auth_credentials_free ()</h3> 1829<pre class="programlisting"><span class="returnvalue">void</span> 1830gst_rtsp_auth_credentials_free (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html#GstRTSPAuthCredential"><span class="type">GstRTSPAuthCredential</span></a> **credentials</code></em>);</pre> 1831<p>Free a <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of credentials returned from 1832<a class="link" href="GstRTSPMessage.html#gst-rtsp-message-parse-auth-credentials" title="gst_rtsp_message_parse_auth_credentials ()"><code class="function">gst_rtsp_message_parse_auth_credentials()</code></a>.</p> 1833<div class="refsect3"> 1834<a name="gst-rtsp-auth-credentials-free.parameters"></a><h4>Parameters</h4> 1835<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1836<colgroup> 1837<col width="150px" class="parameters_name"> 1838<col class="parameters_description"> 1839<col width="200px" class="parameters_annotations"> 1840</colgroup> 1841<tbody><tr> 1842<td class="parameter_name"><p>credentials</p></td> 1843<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <a class="link" href="GstRTSPMessage.html#GstRTSPAuthCredential"><span class="type">GstRTSPAuthCredential</span></a></p></td> 1844<td class="parameter_annotations"> </td> 1845</tr></tbody> 1846</table></div> 1847</div> 1848<p class="since">Since: <a class="link" href="ix05.html#api-index-1.12">1.12</a></p> 1849</div> 1850<hr> 1851<div class="refsect2"> 1852<a name="gst-rtsp-auth-param-copy"></a><h3>gst_rtsp_auth_param_copy ()</h3> 1853<pre class="programlisting"><a class="link" href="GstRTSPMessage.html#GstRTSPAuthParam"><span class="returnvalue">GstRTSPAuthParam</span></a> * 1854gst_rtsp_auth_param_copy (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html#GstRTSPAuthParam"><span class="type">GstRTSPAuthParam</span></a> *param</code></em>);</pre> 1855</div> 1856<hr> 1857<div class="refsect2"> 1858<a name="gst-rtsp-auth-param-free"></a><h3>gst_rtsp_auth_param_free ()</h3> 1859<pre class="programlisting"><span class="returnvalue">void</span> 1860gst_rtsp_auth_param_free (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html#GstRTSPAuthParam"><span class="type">GstRTSPAuthParam</span></a> *param</code></em>);</pre> 1861</div> 1862<hr> 1863<div class="refsect2"> 1864<a name="gst-rtsp-message-dump"></a><h3>gst_rtsp_message_dump ()</h3> 1865<pre class="programlisting"><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPResult" title="enum GstRTSPResult"><span class="returnvalue">GstRTSPResult</span></a> 1866gst_rtsp_message_dump (<em class="parameter"><code><a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a> *msg</code></em>);</pre> 1867<p>Dump the contents of <em class="parameter"><code>msg</code></em> 1868 to stdout.</p> 1869<div class="refsect3"> 1870<a name="gst-rtsp-message-dump.parameters"></a><h4>Parameters</h4> 1871<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1872<colgroup> 1873<col width="150px" class="parameters_name"> 1874<col class="parameters_description"> 1875<col width="200px" class="parameters_annotations"> 1876</colgroup> 1877<tbody><tr> 1878<td class="parameter_name"><p>msg</p></td> 1879<td class="parameter_description"><p>a <a class="link" href="GstRTSPMessage.html" title="GstRTSPMessage"><span class="type">GstRTSPMessage</span></a></p></td> 1880<td class="parameter_annotations"> </td> 1881</tr></tbody> 1882</table></div> 1883</div> 1884<div class="refsect3"> 1885<a name="gst-rtsp-message-dump.returns"></a><h4>Returns</h4> 1886<p> <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.</p> 1887</div> 1888</div> 1889</div> 1890<div class="refsect1"> 1891<a name="GstRTSPMessage.other_details"></a><h2>Types and Values</h2> 1892<div class="refsect2"> 1893<a name="GstRTSPMsgType"></a><h3>enum GstRTSPMsgType</h3> 1894<p>The type of a message.</p> 1895<div class="refsect3"> 1896<a name="GstRTSPMsgType.members"></a><h4>Members</h4> 1897<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1898<colgroup> 1899<col width="300px" class="enum_members_name"> 1900<col class="enum_members_description"> 1901<col width="200px" class="enum_members_annotations"> 1902</colgroup> 1903<tbody> 1904<tr> 1905<td class="enum_member_name"><p><a name="GST-RTSP-MESSAGE-INVALID:CAPS"></a>GST_RTSP_MESSAGE_INVALID</p></td> 1906<td class="enum_member_description"> 1907<p>invalid message type</p> 1908</td> 1909<td class="enum_member_annotations"> </td> 1910</tr> 1911<tr> 1912<td class="enum_member_name"><p><a name="GST-RTSP-MESSAGE-REQUEST:CAPS"></a>GST_RTSP_MESSAGE_REQUEST</p></td> 1913<td class="enum_member_description"> 1914<p>RTSP request message</p> 1915</td> 1916<td class="enum_member_annotations"> </td> 1917</tr> 1918<tr> 1919<td class="enum_member_name"><p><a name="GST-RTSP-MESSAGE-RESPONSE:CAPS"></a>GST_RTSP_MESSAGE_RESPONSE</p></td> 1920<td class="enum_member_description"> 1921<p>RTSP response message</p> 1922</td> 1923<td class="enum_member_annotations"> </td> 1924</tr> 1925<tr> 1926<td class="enum_member_name"><p><a name="GST-RTSP-MESSAGE-HTTP-REQUEST:CAPS"></a>GST_RTSP_MESSAGE_HTTP_REQUEST</p></td> 1927<td class="enum_member_description"> 1928<p>HTTP request message.</p> 1929</td> 1930<td class="enum_member_annotations"> </td> 1931</tr> 1932<tr> 1933<td class="enum_member_name"><p><a name="GST-RTSP-MESSAGE-HTTP-RESPONSE:CAPS"></a>GST_RTSP_MESSAGE_HTTP_RESPONSE</p></td> 1934<td class="enum_member_description"> 1935<p>HTTP response message.</p> 1936</td> 1937<td class="enum_member_annotations"> </td> 1938</tr> 1939<tr> 1940<td class="enum_member_name"><p><a name="GST-RTSP-MESSAGE-DATA:CAPS"></a>GST_RTSP_MESSAGE_DATA</p></td> 1941<td class="enum_member_description"> 1942<p>data message</p> 1943</td> 1944<td class="enum_member_annotations"> </td> 1945</tr> 1946</tbody> 1947</table></div> 1948</div> 1949</div> 1950<hr> 1951<div class="refsect2"> 1952<a name="GstRTSPMessage-struct"></a><h3>struct GstRTSPMessage</h3> 1953<pre class="programlisting">struct GstRTSPMessage { 1954 GstRTSPMsgType type; 1955 1956 union { 1957 struct { 1958 GstRTSPMethod method; 1959 gchar *uri; 1960 GstRTSPVersion version; 1961 } request; 1962 struct { 1963 GstRTSPStatusCode code; 1964 gchar *reason; 1965 GstRTSPVersion version; 1966 } response; 1967 struct { 1968 guint8 channel; 1969 } data; 1970 } type_data; 1971}; 1972</pre> 1973<p>An RTSP message containing request, response or data messages. Depending on 1974the <em class="parameter"><code>type</code></em> 1975, the appropriate structure may be accessed.</p> 1976<div class="refsect3"> 1977<a name="GstRTSPMessage.members"></a><h4>Members</h4> 1978<div class="informaltable"><table class="informaltable" width="100%" border="0"> 1979<colgroup> 1980<col width="300px" class="struct_members_name"> 1981<col class="struct_members_description"> 1982<col width="200px" class="struct_members_annotations"> 1983</colgroup> 1984<tbody><tr> 1985<td class="struct_member_name"><p><a class="link" href="GstRTSPMessage.html#GstRTSPMsgType" title="enum GstRTSPMsgType"><span class="type">GstRTSPMsgType</span></a> <em class="structfield"><code><a name="GstRTSPMessage-struct.type"></a>type</code></em>;</p></td> 1986<td class="struct_member_description"><p>the message type</p></td> 1987<td class="struct_member_annotations"> </td> 1988</tr></tbody> 1989</table></div> 1990</div> 1991</div> 1992<hr> 1993<div class="refsect2"> 1994<a name="GstRTSPAuthCredential-struct"></a><h3>struct GstRTSPAuthCredential</h3> 1995<pre class="programlisting">struct GstRTSPAuthCredential { 1996 GstRTSPAuthMethod scheme; 1997 1998 /* For Basic/Digest WWW-Authenticate and Digest 1999 * Authorization */ 2000 GstRTSPAuthParam **params; /* NULL terminated */ 2001 2002 /* For Basic Authorization */ 2003 gchar *authorization; 2004}; 2005</pre> 2006<p>RTSP Authentication credentials</p> 2007<div class="refsect3"> 2008<a name="GstRTSPAuthCredential.members"></a><h4>Members</h4> 2009<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2010<colgroup> 2011<col width="300px" class="struct_members_name"> 2012<col class="struct_members_description"> 2013<col width="200px" class="struct_members_annotations"> 2014</colgroup> 2015<tbody> 2016<tr> 2017<td class="struct_member_name"><p><a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPAuthMethod" title="enum GstRTSPAuthMethod"><span class="type">GstRTSPAuthMethod</span></a> <em class="structfield"><code><a name="GstRTSPAuthCredential-struct.scheme"></a>scheme</code></em>;</p></td> 2018<td class="struct_member_description"><p>a <a class="link" href="gst-plugins-base-libs-GstRtspdefs.html#GstRTSPAuthMethod" title="enum GstRTSPAuthMethod"><span class="type">GstRTSPAuthMethod</span></a></p></td> 2019<td class="struct_member_annotations"> </td> 2020</tr> 2021<tr> 2022<td class="struct_member_name"><p><a class="link" href="GstRTSPMessage.html#GstRTSPAuthParam"><span class="type">GstRTSPAuthParam</span></a> **<em class="structfield"><code><a name="GstRTSPAuthCredential-struct.params"></a>params</code></em>;</p></td> 2023<td class="struct_member_description"><p>A NULL-terminated array of <a class="link" href="GstRTSPMessage.html#GstRTSPAuthParam"><span class="type">GstRTSPAuthParam</span></a></p></td> 2024<td class="struct_member_annotations"> </td> 2025</tr> 2026<tr> 2027<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="GstRTSPAuthCredential-struct.authorization"></a>authorization</code></em>;</p></td> 2028<td class="struct_member_description"><p>The authorization for the basic schem</p></td> 2029<td class="struct_member_annotations"> </td> 2030</tr> 2031</tbody> 2032</table></div> 2033</div> 2034</div> 2035<hr> 2036<div class="refsect2"> 2037<a name="GstRTSPAuthParam-struct"></a><h3>struct GstRTSPAuthParam</h3> 2038<pre class="programlisting">struct GstRTSPAuthParam { 2039 gchar *name; 2040 gchar *value; 2041}; 2042</pre> 2043<p>RTSP Authentication parameter</p> 2044<div class="refsect3"> 2045<a name="GstRTSPAuthParam.members"></a><h4>Members</h4> 2046<div class="informaltable"><table class="informaltable" width="100%" border="0"> 2047<colgroup> 2048<col width="300px" class="struct_members_name"> 2049<col class="struct_members_description"> 2050<col width="200px" class="struct_members_annotations"> 2051</colgroup> 2052<tbody> 2053<tr> 2054<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="GstRTSPAuthParam-struct.name"></a>name</code></em>;</p></td> 2055<td class="struct_member_description"><p>The name of the parameter</p></td> 2056<td class="struct_member_annotations"> </td> 2057</tr> 2058<tr> 2059<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="GstRTSPAuthParam-struct.value"></a>value</code></em>;</p></td> 2060<td class="struct_member_description"><p>The value of the parameter</p></td> 2061<td class="struct_member_annotations"> </td> 2062</tr> 2063</tbody> 2064</table></div> 2065</div> 2066</div> 2067</div> 2068<div class="refsect1"> 2069<a name="GstRTSPMessage.see-also"></a><h2>See Also</h2> 2070<p>gstrtspconnection</p> 2071</div> 2072</div> 2073<div class="footer"> 2074<hr>Generated by GTK-Doc V1.28</div> 2075</body> 2076</html>
