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>Missing plugins: 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-base-utils.html" title="Base Utils Library"> 9<link rel="prev" href="gst-plugins-base-libs-Descriptions.html" title="Descriptions"> 10<link rel="next" href="gst-plugins-base-libs-Install-plugins.html" title="Install-plugins"> 11<meta name="generator" content="GTK-Doc V1.28 (XML mode)"> 12<link rel="stylesheet" href="style.css" type="text/css"> 13</head> 14<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 15<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> 16<td width="100%" align="left" class="shortcuts"> 17<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 18 <a href="#gst-plugins-base-libs-Missing-plugins.description" class="shortcut">Description</a></span> 19</td> 20<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> 21<td><a accesskey="u" href="gstreamer-base-utils.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 22<td><a accesskey="p" href="gst-plugins-base-libs-Descriptions.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 23<td><a accesskey="n" href="gst-plugins-base-libs-Install-plugins.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> 24</tr></table> 25<div class="refentry"> 26<a name="gst-plugins-base-libs-Missing-plugins"></a><div class="titlepage"></div> 27<div class="refnamediv"><table width="100%"><tr> 28<td valign="top"> 29<h2><span class="refentrytitle"><a name="gst-plugins-base-libs-Missing-plugins.top_of_page"></a>Missing plugins</span></h2> 30<p>Missing plugins — Create, recognise and parse missing-plugins messages</p> 31</td> 32<td class="gallery_image" valign="top" align="right"></td> 33</tr></table></div> 34<div class="refsect1"> 35<a name="gst-plugins-base-libs-Missing-plugins.functions"></a><h2>Functions</h2> 36<div class="informaltable"><table class="informaltable" width="100%" border="0"> 37<colgroup> 38<col width="150px" class="functions_return"> 39<col class="functions_name"> 40</colgroup> 41<tbody> 42<tr> 43<td class="function_type"> 44<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 45</td> 46<td class="function_name"> 47<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-plugin-message-get-installer-detail" title="gst_missing_plugin_message_get_installer_detail ()">gst_missing_plugin_message_get_installer_detail</a> <span class="c_punctuation">()</span> 48</td> 49</tr> 50<tr> 51<td class="function_type"> 52<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 53</td> 54<td class="function_name"> 55<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-plugin-message-get-description" title="gst_missing_plugin_message_get_description ()">gst_missing_plugin_message_get_description</a> <span class="c_punctuation">()</span> 56</td> 57</tr> 58<tr> 59<td class="function_type"> 60<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 61</td> 62<td class="function_name"> 63<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-is-missing-plugin-message" title="gst_is_missing_plugin_message ()">gst_is_missing_plugin_message</a> <span class="c_punctuation">()</span> 64</td> 65</tr> 66<tr> 67<td class="function_type"> 68<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 69</td> 70<td class="function_name"> 71<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-decoder-message-new" title="gst_missing_decoder_message_new ()">gst_missing_decoder_message_new</a> <span class="c_punctuation">()</span> 72</td> 73</tr> 74<tr> 75<td class="function_type"> 76<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 77</td> 78<td class="function_name"> 79<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-encoder-message-new" title="gst_missing_encoder_message_new ()">gst_missing_encoder_message_new</a> <span class="c_punctuation">()</span> 80</td> 81</tr> 82<tr> 83<td class="function_type"> 84<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 85</td> 86<td class="function_name"> 87<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-uri-source-message-new" title="gst_missing_uri_source_message_new ()">gst_missing_uri_source_message_new</a> <span class="c_punctuation">()</span> 88</td> 89</tr> 90<tr> 91<td class="function_type"> 92<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 93</td> 94<td class="function_name"> 95<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-uri-sink-message-new" title="gst_missing_uri_sink_message_new ()">gst_missing_uri_sink_message_new</a> <span class="c_punctuation">()</span> 96</td> 97</tr> 98<tr> 99<td class="function_type"> 100<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 101</td> 102<td class="function_name"> 103<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-element-message-new" title="gst_missing_element_message_new ()">gst_missing_element_message_new</a> <span class="c_punctuation">()</span> 104</td> 105</tr> 106<tr> 107<td class="function_type"> 108<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 109</td> 110<td class="function_name"> 111<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-uri-source-installer-detail-new" title="gst_missing_uri_source_installer_detail_new ()">gst_missing_uri_source_installer_detail_new</a> <span class="c_punctuation">()</span> 112</td> 113</tr> 114<tr> 115<td class="function_type"> 116<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 117</td> 118<td class="function_name"> 119<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-uri-sink-installer-detail-new" title="gst_missing_uri_sink_installer_detail_new ()">gst_missing_uri_sink_installer_detail_new</a> <span class="c_punctuation">()</span> 120</td> 121</tr> 122<tr> 123<td class="function_type"> 124<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 125</td> 126<td class="function_name"> 127<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-element-installer-detail-new" title="gst_missing_element_installer_detail_new ()">gst_missing_element_installer_detail_new</a> <span class="c_punctuation">()</span> 128</td> 129</tr> 130<tr> 131<td class="function_type"> 132<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 133</td> 134<td class="function_name"> 135<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-decoder-installer-detail-new" title="gst_missing_decoder_installer_detail_new ()">gst_missing_decoder_installer_detail_new</a> <span class="c_punctuation">()</span> 136</td> 137</tr> 138<tr> 139<td class="function_type"> 140<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 141</td> 142<td class="function_name"> 143<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-encoder-installer-detail-new" title="gst_missing_encoder_installer_detail_new ()">gst_missing_encoder_installer_detail_new</a> <span class="c_punctuation">()</span> 144</td> 145</tr> 146</tbody> 147</table></div> 148</div> 149<div class="refsect1"> 150<a name="gst-plugins-base-libs-Missing-plugins.includes"></a><h2>Includes</h2> 151<pre class="synopsis">#include <gst/pbutils/pbutils.h> 152</pre> 153</div> 154<div class="refsect1"> 155<a name="gst-plugins-base-libs-Missing-plugins.description"></a><h2>Description</h2> 156<p>Functions to create, recognise and parse missing-plugins messages for 157applications and elements.</p> 158<p>Missing-plugin messages are posted on the bus by elements like decodebin 159or playbin if they can't find an appropriate source element or decoder 160element. The application can use these messages for two things:</p> 161<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 162<li class="listitem"><p>concise error/problem reporting to the user mentioning what exactly 163is missing, see <a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-plugin-message-get-description" title="gst_missing_plugin_message_get_description ()"><code class="function">gst_missing_plugin_message_get_description()</code></a></p></li> 164<li class="listitem"><p>initiate installation of missing plugins, see 165<a class="link" href="gst-plugins-base-libs-Missing-plugins.html#gst-missing-plugin-message-get-installer-detail" title="gst_missing_plugin_message_get_installer_detail ()"><code class="function">gst_missing_plugin_message_get_installer_detail()</code></a> and 166<a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-async" title="gst_install_plugins_async ()"><code class="function">gst_install_plugins_async()</code></a></p></li> 167</ul></div> 168<p>Applications may also create missing-plugin messages themselves to install 169required elements that are missing, using the install mechanism mentioned 170above.</p> 171</div> 172<div class="refsect1"> 173<a name="gst-plugins-base-libs-Missing-plugins.functions_details"></a><h2>Functions</h2> 174<div class="refsect2"> 175<a name="gst-missing-plugin-message-get-installer-detail"></a><h3>gst_missing_plugin_message_get_installer_detail ()</h3> 176<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 177gst_missing_plugin_message_get_installer_detail 178 (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a> *msg</code></em>);</pre> 179<p>Returns an opaque string containing all the details about the missing 180element to be passed to an external installer called via 181<a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-async" title="gst_install_plugins_async ()"><code class="function">gst_install_plugins_async()</code></a> or <a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-sync" title="gst_install_plugins_sync ()"><code class="function">gst_install_plugins_sync()</code></a>.</p> 182<p>This function is mainly for applications that call external plugin 183installation mechanisms using one of the two above-mentioned functions.</p> 184<div class="refsect3"> 185<a name="gst-missing-plugin-message-get-installer-detail.parameters"></a><h4>Parameters</h4> 186<div class="informaltable"><table class="informaltable" width="100%" border="0"> 187<colgroup> 188<col width="150px" class="parameters_name"> 189<col class="parameters_description"> 190<col width="200px" class="parameters_annotations"> 191</colgroup> 192<tbody><tr> 193<td class="parameter_name"><p>msg</p></td> 194<td class="parameter_description"><p>a missing-plugin <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a> of type <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GST-MESSAGE-ELEMENT:CAPS"><span class="type">GST_MESSAGE_ELEMENT</span></a></p></td> 195<td class="parameter_annotations"> </td> 196</tr></tbody> 197</table></div> 198</div> 199<div class="refsect3"> 200<a name="gst-missing-plugin-message-get-installer-detail.returns"></a><h4>Returns</h4> 201<p> a newly-allocated detail string, or NULL on error. Free string 202with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when not needed any longer.</p> 203</div> 204</div> 205<hr> 206<div class="refsect2"> 207<a name="gst-missing-plugin-message-get-description"></a><h3>gst_missing_plugin_message_get_description ()</h3> 208<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 209gst_missing_plugin_message_get_description 210 (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a> *msg</code></em>);</pre> 211<p>Returns a localised string describing the missing feature, for use in 212error dialogs and the like. Should never return NULL unless <em class="parameter"><code>msg</code></em> 213 is not 214a valid missing-plugin message.</p> 215<p>This function is mainly for applications that need a human-readable string 216describing a missing plugin, given a previously collected missing-plugin 217message</p> 218<div class="refsect3"> 219<a name="gst-missing-plugin-message-get-description.parameters"></a><h4>Parameters</h4> 220<div class="informaltable"><table class="informaltable" width="100%" border="0"> 221<colgroup> 222<col width="150px" class="parameters_name"> 223<col class="parameters_description"> 224<col width="200px" class="parameters_annotations"> 225</colgroup> 226<tbody><tr> 227<td class="parameter_name"><p>msg</p></td> 228<td class="parameter_description"><p>a missing-plugin <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a> of type <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GST-MESSAGE-ELEMENT:CAPS"><span class="type">GST_MESSAGE_ELEMENT</span></a></p></td> 229<td class="parameter_annotations"> </td> 230</tr></tbody> 231</table></div> 232</div> 233<div class="refsect3"> 234<a name="gst-missing-plugin-message-get-description.returns"></a><h4>Returns</h4> 235<p> a newly-allocated description string, or NULL on error. Free 236string with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when not needed any longer.</p> 237</div> 238</div> 239<hr> 240<div class="refsect2"> 241<a name="gst-is-missing-plugin-message"></a><h3>gst_is_missing_plugin_message ()</h3> 242<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 243gst_is_missing_plugin_message (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a> *msg</code></em>);</pre> 244<p>Checks whether <em class="parameter"><code>msg</code></em> 245 is a missing plugins message.</p> 246<div class="refsect3"> 247<a name="gst-is-missing-plugin-message.parameters"></a><h4>Parameters</h4> 248<div class="informaltable"><table class="informaltable" width="100%" border="0"> 249<colgroup> 250<col width="150px" class="parameters_name"> 251<col class="parameters_description"> 252<col width="200px" class="parameters_annotations"> 253</colgroup> 254<tbody><tr> 255<td class="parameter_name"><p>msg</p></td> 256<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a></p></td> 257<td class="parameter_annotations"> </td> 258</tr></tbody> 259</table></div> 260</div> 261<div class="refsect3"> 262<a name="gst-is-missing-plugin-message.returns"></a><h4>Returns</h4> 263<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> 264is a missing-plugins message, otherwise <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p> 265</div> 266</div> 267<hr> 268<div class="refsect2"> 269<a name="gst-missing-decoder-message-new"></a><h3>gst_missing_decoder_message_new ()</h3> 270<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 271gst_missing_decoder_message_new (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> *element</code></em>, 272 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *decode_caps</code></em>);</pre> 273<p>Creates a missing-plugin message for <em class="parameter"><code>element</code></em> 274 to notify the application 275that a decoder element for a particular set of (fixed) caps is missing. 276This function is mainly for use in plugins.</p> 277<div class="refsect3"> 278<a name="gst-missing-decoder-message-new.parameters"></a><h4>Parameters</h4> 279<div class="informaltable"><table class="informaltable" width="100%" border="0"> 280<colgroup> 281<col width="150px" class="parameters_name"> 282<col class="parameters_description"> 283<col width="200px" class="parameters_annotations"> 284</colgroup> 285<tbody> 286<tr> 287<td class="parameter_name"><p>element</p></td> 288<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> posting the message</p></td> 289<td class="parameter_annotations"> </td> 290</tr> 291<tr> 292<td class="parameter_name"><p>decode_caps</p></td> 293<td class="parameter_description"><p>the (fixed) caps for which a decoder element is needed</p></td> 294<td class="parameter_annotations"> </td> 295</tr> 296</tbody> 297</table></div> 298</div> 299<div class="refsect3"> 300<a name="gst-missing-decoder-message-new.returns"></a><h4>Returns</h4> 301<p>a new <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a>, or NULL on error. </p> 302<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 303</div> 304</div> 305<hr> 306<div class="refsect2"> 307<a name="gst-missing-encoder-message-new"></a><h3>gst_missing_encoder_message_new ()</h3> 308<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 309gst_missing_encoder_message_new (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> *element</code></em>, 310 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *encode_caps</code></em>);</pre> 311<p>Creates a missing-plugin message for <em class="parameter"><code>element</code></em> 312 to notify the application 313that an encoder element for a particular set of (fixed) caps is missing. 314This function is mainly for use in plugins.</p> 315<div class="refsect3"> 316<a name="gst-missing-encoder-message-new.parameters"></a><h4>Parameters</h4> 317<div class="informaltable"><table class="informaltable" width="100%" border="0"> 318<colgroup> 319<col width="150px" class="parameters_name"> 320<col class="parameters_description"> 321<col width="200px" class="parameters_annotations"> 322</colgroup> 323<tbody> 324<tr> 325<td class="parameter_name"><p>element</p></td> 326<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> posting the message</p></td> 327<td class="parameter_annotations"> </td> 328</tr> 329<tr> 330<td class="parameter_name"><p>encode_caps</p></td> 331<td class="parameter_description"><p>the (fixed) caps for which an encoder element is needed</p></td> 332<td class="parameter_annotations"> </td> 333</tr> 334</tbody> 335</table></div> 336</div> 337<div class="refsect3"> 338<a name="gst-missing-encoder-message-new.returns"></a><h4>Returns</h4> 339<p>a new <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a>, or NULL on error. </p> 340<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 341</div> 342</div> 343<hr> 344<div class="refsect2"> 345<a name="gst-missing-uri-source-message-new"></a><h3>gst_missing_uri_source_message_new ()</h3> 346<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 347gst_missing_uri_source_message_new (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> *element</code></em>, 348 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *protocol</code></em>);</pre> 349<p>Creates a missing-plugin message for <em class="parameter"><code>element</code></em> 350 to notify the application 351that a source element for a particular URI protocol is missing. This 352function is mainly for use in plugins.</p> 353<div class="refsect3"> 354<a name="gst-missing-uri-source-message-new.parameters"></a><h4>Parameters</h4> 355<div class="informaltable"><table class="informaltable" width="100%" border="0"> 356<colgroup> 357<col width="150px" class="parameters_name"> 358<col class="parameters_description"> 359<col width="200px" class="parameters_annotations"> 360</colgroup> 361<tbody> 362<tr> 363<td class="parameter_name"><p>element</p></td> 364<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> posting the message</p></td> 365<td class="parameter_annotations"> </td> 366</tr> 367<tr> 368<td class="parameter_name"><p>protocol</p></td> 369<td class="parameter_description"><p>the URI protocol the missing source needs to implement, 370e.g. "http" or "mms"</p></td> 371<td class="parameter_annotations"> </td> 372</tr> 373</tbody> 374</table></div> 375</div> 376<div class="refsect3"> 377<a name="gst-missing-uri-source-message-new.returns"></a><h4>Returns</h4> 378<p>a new <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a>, or NULL on error. </p> 379<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 380</div> 381</div> 382<hr> 383<div class="refsect2"> 384<a name="gst-missing-uri-sink-message-new"></a><h3>gst_missing_uri_sink_message_new ()</h3> 385<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 386gst_missing_uri_sink_message_new (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> *element</code></em>, 387 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *protocol</code></em>);</pre> 388<p>Creates a missing-plugin message for <em class="parameter"><code>element</code></em> 389 to notify the application 390that a sink element for a particular URI protocol is missing. This 391function is mainly for use in plugins.</p> 392<div class="refsect3"> 393<a name="gst-missing-uri-sink-message-new.parameters"></a><h4>Parameters</h4> 394<div class="informaltable"><table class="informaltable" width="100%" border="0"> 395<colgroup> 396<col width="150px" class="parameters_name"> 397<col class="parameters_description"> 398<col width="200px" class="parameters_annotations"> 399</colgroup> 400<tbody> 401<tr> 402<td class="parameter_name"><p>element</p></td> 403<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> posting the message</p></td> 404<td class="parameter_annotations"> </td> 405</tr> 406<tr> 407<td class="parameter_name"><p>protocol</p></td> 408<td class="parameter_description"><p>the URI protocol the missing sink needs to implement, 409e.g. "http" or "smb"</p></td> 410<td class="parameter_annotations"> </td> 411</tr> 412</tbody> 413</table></div> 414</div> 415<div class="refsect3"> 416<a name="gst-missing-uri-sink-message-new.returns"></a><h4>Returns</h4> 417<p>a new <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a>, or NULL on error. </p> 418<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 419</div> 420</div> 421<hr> 422<div class="refsect2"> 423<a name="gst-missing-element-message-new"></a><h3>gst_missing_element_message_new ()</h3> 424<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="returnvalue">GstMessage</span></a> * 425gst_missing_element_message_new (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> *element</code></em>, 426 <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *factory_name</code></em>);</pre> 427<p>Creates a missing-plugin message for <em class="parameter"><code>element</code></em> 428 to notify the application 429that a certain required element is missing. This function is mainly for 430use in plugins.</p> 431<div class="refsect3"> 432<a name="gst-missing-element-message-new.parameters"></a><h4>Parameters</h4> 433<div class="informaltable"><table class="informaltable" width="100%" border="0"> 434<colgroup> 435<col width="150px" class="parameters_name"> 436<col class="parameters_description"> 437<col width="200px" class="parameters_annotations"> 438</colgroup> 439<tbody> 440<tr> 441<td class="parameter_name"><p>element</p></td> 442<td class="parameter_description"><p>the <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct"><span class="type">GstElement</span></a> posting the message</p></td> 443<td class="parameter_annotations"> </td> 444</tr> 445<tr> 446<td class="parameter_name"><p>factory_name</p></td> 447<td class="parameter_description"><p>the name of the missing element (element factory), 448e.g. "videoscale" or "cdparanoiasrc"</p></td> 449<td class="parameter_annotations"> </td> 450</tr> 451</tbody> 452</table></div> 453</div> 454<div class="refsect3"> 455<a name="gst-missing-element-message-new.returns"></a><h4>Returns</h4> 456<p>a new <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstMessage.html#GstMessage-struct"><span class="type">GstMessage</span></a>, or NULL on error. </p> 457<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> 458</div> 459</div> 460<hr> 461<div class="refsect2"> 462<a name="gst-missing-uri-source-installer-detail-new"></a><h3>gst_missing_uri_source_installer_detail_new ()</h3> 463<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 464gst_missing_uri_source_installer_detail_new 465 (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *protocol</code></em>);</pre> 466<p>Returns an opaque string containing all the details about the missing 467element to be passed to an external installer called via 468<a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-async" title="gst_install_plugins_async ()"><code class="function">gst_install_plugins_async()</code></a> or <a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-sync" title="gst_install_plugins_sync ()"><code class="function">gst_install_plugins_sync()</code></a>.</p> 469<p>This function is mainly for applications that call external plugin 470installation mechanisms using one of the two above-mentioned functions in 471the case where the application knows exactly what kind of plugin it is 472missing.</p> 473<div class="refsect3"> 474<a name="gst-missing-uri-source-installer-detail-new.parameters"></a><h4>Parameters</h4> 475<div class="informaltable"><table class="informaltable" width="100%" border="0"> 476<colgroup> 477<col width="150px" class="parameters_name"> 478<col class="parameters_description"> 479<col width="200px" class="parameters_annotations"> 480</colgroup> 481<tbody><tr> 482<td class="parameter_name"><p>protocol</p></td> 483<td class="parameter_description"><p>the URI protocol the missing source needs to implement, 484e.g. "http" or "mms"</p></td> 485<td class="parameter_annotations"> </td> 486</tr></tbody> 487</table></div> 488</div> 489<div class="refsect3"> 490<a name="gst-missing-uri-source-installer-detail-new.returns"></a><h4>Returns</h4> 491<p> a newly-allocated detail string, or NULL on error. Free string 492with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when not needed any longer.</p> 493</div> 494</div> 495<hr> 496<div class="refsect2"> 497<a name="gst-missing-uri-sink-installer-detail-new"></a><h3>gst_missing_uri_sink_installer_detail_new ()</h3> 498<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 499gst_missing_uri_sink_installer_detail_new 500 (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *protocol</code></em>);</pre> 501<p>Returns an opaque string containing all the details about the missing 502element to be passed to an external installer called via 503<a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-async" title="gst_install_plugins_async ()"><code class="function">gst_install_plugins_async()</code></a> or <a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-sync" title="gst_install_plugins_sync ()"><code class="function">gst_install_plugins_sync()</code></a>.</p> 504<p>This function is mainly for applications that call external plugin 505installation mechanisms using one of the two above-mentioned functions in 506the case where the application knows exactly what kind of plugin it is 507missing.</p> 508<div class="refsect3"> 509<a name="gst-missing-uri-sink-installer-detail-new.parameters"></a><h4>Parameters</h4> 510<div class="informaltable"><table class="informaltable" width="100%" border="0"> 511<colgroup> 512<col width="150px" class="parameters_name"> 513<col class="parameters_description"> 514<col width="200px" class="parameters_annotations"> 515</colgroup> 516<tbody><tr> 517<td class="parameter_name"><p>protocol</p></td> 518<td class="parameter_description"><p>the URI protocol the missing source needs to implement, 519e.g. "http" or "mms"</p></td> 520<td class="parameter_annotations"> </td> 521</tr></tbody> 522</table></div> 523</div> 524<div class="refsect3"> 525<a name="gst-missing-uri-sink-installer-detail-new.returns"></a><h4>Returns</h4> 526<p> a newly-allocated detail string, or NULL on error. Free string 527with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when not needed any longer.</p> 528</div> 529</div> 530<hr> 531<div class="refsect2"> 532<a name="gst-missing-element-installer-detail-new"></a><h3>gst_missing_element_installer_detail_new ()</h3> 533<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 534gst_missing_element_installer_detail_new 535 (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *factory_name</code></em>);</pre> 536<p>Returns an opaque string containing all the details about the missing 537element to be passed to an external installer called via 538<a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-async" title="gst_install_plugins_async ()"><code class="function">gst_install_plugins_async()</code></a> or <a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-sync" title="gst_install_plugins_sync ()"><code class="function">gst_install_plugins_sync()</code></a>.</p> 539<p>This function is mainly for applications that call external plugin 540installation mechanisms using one of the two above-mentioned functions in 541the case where the application knows exactly what kind of plugin it is 542missing.</p> 543<div class="refsect3"> 544<a name="gst-missing-element-installer-detail-new.parameters"></a><h4>Parameters</h4> 545<div class="informaltable"><table class="informaltable" width="100%" border="0"> 546<colgroup> 547<col width="150px" class="parameters_name"> 548<col class="parameters_description"> 549<col width="200px" class="parameters_annotations"> 550</colgroup> 551<tbody><tr> 552<td class="parameter_name"><p>factory_name</p></td> 553<td class="parameter_description"><p>the name of the missing element (element factory), 554e.g. "videoscale" or "cdparanoiasrc"</p></td> 555<td class="parameter_annotations"> </td> 556</tr></tbody> 557</table></div> 558</div> 559<div class="refsect3"> 560<a name="gst-missing-element-installer-detail-new.returns"></a><h4>Returns</h4> 561<p> a newly-allocated detail string, or NULL on error. Free string 562with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when not needed any longer.</p> 563</div> 564</div> 565<hr> 566<div class="refsect2"> 567<a name="gst-missing-decoder-installer-detail-new"></a><h3>gst_missing_decoder_installer_detail_new ()</h3> 568<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 569gst_missing_decoder_installer_detail_new 570 (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *decode_caps</code></em>);</pre> 571<p>Returns an opaque string containing all the details about the missing 572element to be passed to an external installer called via 573<a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-async" title="gst_install_plugins_async ()"><code class="function">gst_install_plugins_async()</code></a> or <a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-sync" title="gst_install_plugins_sync ()"><code class="function">gst_install_plugins_sync()</code></a>.</p> 574<p>This function is mainly for applications that call external plugin 575installation mechanisms using one of the two above-mentioned functions in 576the case where the application knows exactly what kind of plugin it is 577missing.</p> 578<div class="refsect3"> 579<a name="gst-missing-decoder-installer-detail-new.parameters"></a><h4>Parameters</h4> 580<div class="informaltable"><table class="informaltable" width="100%" border="0"> 581<colgroup> 582<col width="150px" class="parameters_name"> 583<col class="parameters_description"> 584<col width="200px" class="parameters_annotations"> 585</colgroup> 586<tbody><tr> 587<td class="parameter_name"><p>decode_caps</p></td> 588<td class="parameter_description"><p>the (fixed) caps for which a decoder element is needed</p></td> 589<td class="parameter_annotations"> </td> 590</tr></tbody> 591</table></div> 592</div> 593<div class="refsect3"> 594<a name="gst-missing-decoder-installer-detail-new.returns"></a><h4>Returns</h4> 595<p> a newly-allocated detail string, or NULL on error. Free string 596with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when not needed any longer.</p> 597</div> 598</div> 599<hr> 600<div class="refsect2"> 601<a name="gst-missing-encoder-installer-detail-new"></a><h3>gst_missing_encoder_installer_detail_new ()</h3> 602<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * 603gst_missing_encoder_installer_detail_new 604 (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *encode_caps</code></em>);</pre> 605<p>Returns an opaque string containing all the details about the missing 606element to be passed to an external installer called via 607<a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-async" title="gst_install_plugins_async ()"><code class="function">gst_install_plugins_async()</code></a> or <a class="link" href="gst-plugins-base-libs-Install-plugins.html#gst-install-plugins-sync" title="gst_install_plugins_sync ()"><code class="function">gst_install_plugins_sync()</code></a>.</p> 608<p>This function is mainly for applications that call external plugin 609installation mechanisms using one of the two above-mentioned functions in 610the case where the application knows exactly what kind of plugin it is 611missing.</p> 612<div class="refsect3"> 613<a name="gst-missing-encoder-installer-detail-new.parameters"></a><h4>Parameters</h4> 614<div class="informaltable"><table class="informaltable" width="100%" border="0"> 615<colgroup> 616<col width="150px" class="parameters_name"> 617<col class="parameters_description"> 618<col width="200px" class="parameters_annotations"> 619</colgroup> 620<tbody><tr> 621<td class="parameter_name"><p>encode_caps</p></td> 622<td class="parameter_description"><p>the (fixed) caps for which an encoder element is needed</p></td> 623<td class="parameter_annotations"> </td> 624</tr></tbody> 625</table></div> 626</div> 627<div class="refsect3"> 628<a name="gst-missing-encoder-installer-detail-new.returns"></a><h4>Returns</h4> 629<p> a newly-allocated detail string, or NULL on error. Free string 630with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when not needed any longer.</p> 631</div> 632</div> 633</div> 634<div class="refsect1"> 635<a name="gst-plugins-base-libs-Missing-plugins.other_details"></a><h2>Types and Values</h2> 636</div> 637</div> 638<div class="footer"> 639<hr>Generated by GTK-Doc V1.28</div> 640</body> 641</html>
