| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | 
 | <html> | 
 | <head> | 
 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> | 
 | <title>GStreamer 1.0 Core Reference Manual: GstTypeFind</title> | 
 | <meta name="generator" content="DocBook XSL Stylesheets V1.78.1"> | 
 | <link rel="home" href="index.html" title="GStreamer 1.0 Core Reference Manual"> | 
 | <link rel="up" href="libgstreamer.html" title="GStreamer Core Library"> | 
 | <link rel="prev" href="gstreamer-GstTocSetter.html" title="GstTocSetter"> | 
 | <link rel="next" href="GstTypeFindFactory.html" title="GstTypeFindFactory"> | 
 | <meta name="generator" content="GTK-Doc V1.21 (XML mode)"> | 
 | <link rel="stylesheet" href="style.css" type="text/css"> | 
 | </head> | 
 | <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> | 
 | <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> | 
 | <td width="100%" align="left" class="shortcuts"> | 
 | <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span>  | 
 |                   <a href="#gstreamer-GstTypeFind.description" class="shortcut">Description</a></span> | 
 | </td> | 
 | <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> | 
 | <td><a accesskey="u" href="libgstreamer.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> | 
 | <td><a accesskey="p" href="gstreamer-GstTocSetter.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> | 
 | <td><a accesskey="n" href="GstTypeFindFactory.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> | 
 | </tr></table> | 
 | <div class="refentry"> | 
 | <a name="gstreamer-GstTypeFind"></a><div class="titlepage"></div> | 
 | <div class="refnamediv"><table width="100%"><tr> | 
 | <td valign="top"> | 
 | <h2><span class="refentrytitle"><a name="gstreamer-GstTypeFind.top_of_page"></a>GstTypeFind</span></h2> | 
 | <p>GstTypeFind — Stream type detection</p> | 
 | </td> | 
 | <td class="gallery_image" valign="top" align="right"></td> | 
 | </tr></table></div> | 
 | <div class="refsect1"> | 
 | <a name="gstreamer-GstTypeFind.functions"></a><h2>Functions</h2> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="150px" class="functions_return"> | 
 | <col class="functions_name"> | 
 | </colgroup> | 
 | <tbody> | 
 | <tr> | 
 | <td class="function_type"> | 
 | <span class="returnvalue">void</span> | 
 | </td> | 
 | <td class="function_name"> | 
 | <span class="c_punctuation">(</span><a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindFunction" title="GstTypeFindFunction ()">*GstTypeFindFunction</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span> | 
 | </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="function_type">const <span class="returnvalue">guint8</span> * | 
 | </td> | 
 | <td class="function_name"> | 
 | <a class="link" href="gstreamer-GstTypeFind.html#gst-type-find-peek" title="gst_type_find_peek ()">gst_type_find_peek</a> <span class="c_punctuation">()</span> | 
 | </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="function_type"> | 
 | <span class="returnvalue">void</span> | 
 | </td> | 
 | <td class="function_name"> | 
 | <a class="link" href="gstreamer-GstTypeFind.html#gst-type-find-suggest" title="gst_type_find_suggest ()">gst_type_find_suggest</a> <span class="c_punctuation">()</span> | 
 | </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="function_type"> | 
 | <span class="returnvalue">void</span> | 
 | </td> | 
 | <td class="function_name"> | 
 | <a class="link" href="gstreamer-GstTypeFind.html#gst-type-find-suggest-simple" title="gst_type_find_suggest_simple ()">gst_type_find_suggest_simple</a> <span class="c_punctuation">()</span> | 
 | </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="function_type"> | 
 | <span class="returnvalue">guint64</span> | 
 | </td> | 
 | <td class="function_name"> | 
 | <a class="link" href="gstreamer-GstTypeFind.html#gst-type-find-get-length" title="gst_type_find_get_length ()">gst_type_find_get_length</a> <span class="c_punctuation">()</span> | 
 | </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="function_type"> | 
 | <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> | 
 | </td> | 
 | <td class="function_name"> | 
 | <a class="link" href="gstreamer-GstTypeFind.html#gst-type-find-register" title="gst_type_find_register ()">gst_type_find_register</a> <span class="c_punctuation">()</span> | 
 | </td> | 
 | </tr> | 
 | </tbody> | 
 | </table></div> | 
 | </div> | 
 | <div class="refsect1"> | 
 | <a name="gstreamer-GstTypeFind.other"></a><h2>Types and Values</h2> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="150px" class="name"> | 
 | <col class="description"> | 
 | </colgroup> | 
 | <tbody> | 
 | <tr> | 
 | <td class="datatype_keyword">struct</td> | 
 | <td class="function_name"><a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind">GstTypeFind</a></td> | 
 | </tr> | 
 | <tr> | 
 | <td class="datatype_keyword">enum</td> | 
 | <td class="function_name"><a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindProbability" title="enum GstTypeFindProbability">GstTypeFindProbability</a></td> | 
 | </tr> | 
 | </tbody> | 
 | </table></div> | 
 | </div> | 
 | <div class="refsect1"> | 
 | <a name="gstreamer-GstTypeFind.includes"></a><h2>Includes</h2> | 
 | <pre class="synopsis">#include <gst/gst.h> | 
 | </pre> | 
 | </div> | 
 | <div class="refsect1"> | 
 | <a name="gstreamer-GstTypeFind.description"></a><h2>Description</h2> | 
 | <p>The following functions allow you to detect the media type of an unknown | 
 | stream.</p> | 
 | </div> | 
 | <div class="refsect1"> | 
 | <a name="gstreamer-GstTypeFind.functions_details"></a><h2>Functions</h2> | 
 | <div class="refsect2"> | 
 | <a name="GstTypeFindFunction"></a><h3>GstTypeFindFunction ()</h3> | 
 | <pre class="programlisting"><span class="returnvalue">void</span> | 
 | <span class="c_punctuation">(</span>*GstTypeFindFunction<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> *find</code></em>, | 
 |                         <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre> | 
 | <p>A function that will be called by typefinding.</p> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.7.2.5"></a><h4>Parameters</h4> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="150px" class="parameters_name"> | 
 | <col class="parameters_description"> | 
 | <col width="200px" class="parameters_annotations"> | 
 | </colgroup> | 
 | <tbody> | 
 | <tr> | 
 | <td class="parameter_name"><p>find</p></td> | 
 | <td class="parameter_description"><p>A <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> structure</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>user_data</p></td> | 
 | <td class="parameter_description"><p>optional data to pass to the function</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | </tbody> | 
 | </table></div> | 
 | </div> | 
 | </div> | 
 | <hr> | 
 | <div class="refsect2"> | 
 | <a name="gst-type-find-peek"></a><h3>gst_type_find_peek ()</h3> | 
 | <pre class="programlisting">const <span class="returnvalue">guint8</span> * | 
 | gst_type_find_peek (<em class="parameter"><code><a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> *find</code></em>, | 
 |                     <em class="parameter"><code><span class="type">gint64</span> offset</code></em>, | 
 |                     <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>);</pre> | 
 | <p>Returns the <em class="parameter"><code>size</code></em> | 
 |  bytes of the stream to identify beginning at offset. If | 
 | offset is a positive number, the offset is relative to the beginning of the | 
 | stream, if offset is a negative number the offset is relative to the end of | 
 | the stream. The returned memory is valid until the typefinding function | 
 | returns and must not be freed.</p> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.7.3.5"></a><h4>Parameters</h4> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="150px" class="parameters_name"> | 
 | <col class="parameters_description"> | 
 | <col width="200px" class="parameters_annotations"> | 
 | </colgroup> | 
 | <tbody> | 
 | <tr> | 
 | <td class="parameter_name"><p>find</p></td> | 
 | <td class="parameter_description"><p>The <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> object the function was called with</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>offset</p></td> | 
 | <td class="parameter_description"><p>The offset</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>size</p></td> | 
 | <td class="parameter_description"><p>The number of bytes to return</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | </tbody> | 
 | </table></div> | 
 | </div> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.7.3.6"></a><h4>Returns</h4> | 
 | <p> the | 
 | requested data, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if that data is not available. </p> | 
 | <p><span class="annotation">[<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][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> | 
 | </div> | 
 | </div> | 
 | <hr> | 
 | <div class="refsect2"> | 
 | <a name="gst-type-find-suggest"></a><h3>gst_type_find_suggest ()</h3> | 
 | <pre class="programlisting"><span class="returnvalue">void</span> | 
 | gst_type_find_suggest (<em class="parameter"><code><a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> *find</code></em>, | 
 |                        <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> probability</code></em>, | 
 |                        <em class="parameter"><code><a class="link" href="GstCaps.html" title="GstCaps"><span class="type">GstCaps</span></a> *caps</code></em>);</pre> | 
 | <p>If a <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindFunction" title="GstTypeFindFunction ()"><span class="type">GstTypeFindFunction</span></a> calls this function it suggests the caps with the | 
 | given probability. A <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindFunction" title="GstTypeFindFunction ()"><span class="type">GstTypeFindFunction</span></a> may supply different suggestions | 
 | in one call. | 
 | It is up to the caller of the <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindFunction" title="GstTypeFindFunction ()"><span class="type">GstTypeFindFunction</span></a> to interpret these values.</p> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.7.4.5"></a><h4>Parameters</h4> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="150px" class="parameters_name"> | 
 | <col class="parameters_description"> | 
 | <col width="200px" class="parameters_annotations"> | 
 | </colgroup> | 
 | <tbody> | 
 | <tr> | 
 | <td class="parameter_name"><p>find</p></td> | 
 | <td class="parameter_description"><p>The <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> object the function was called with</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>probability</p></td> | 
 | <td class="parameter_description"><p>The probability in percent that the suggestion is right</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>caps</p></td> | 
 | <td class="parameter_description"><p>The fixed <a class="link" href="GstCaps.html" title="GstCaps"><span class="type">GstCaps</span></a> to suggest</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | </tbody> | 
 | </table></div> | 
 | </div> | 
 | </div> | 
 | <hr> | 
 | <div class="refsect2"> | 
 | <a name="gst-type-find-suggest-simple"></a><h3>gst_type_find_suggest_simple ()</h3> | 
 | <pre class="programlisting"><span class="returnvalue">void</span> | 
 | gst_type_find_suggest_simple (<em class="parameter"><code><a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> *find</code></em>, | 
 |                               <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> probability</code></em>, | 
 |                               <em class="parameter"><code>const <span class="type">char</span> *media_type</code></em>, | 
 |                               <em class="parameter"><code>const <span class="type">char</span> *fieldname</code></em>, | 
 |                               <em class="parameter"><code>...</code></em>);</pre> | 
 | <p>If a <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindFunction" title="GstTypeFindFunction ()"><span class="type">GstTypeFindFunction</span></a> calls this function it suggests the caps with the | 
 | given probability. A <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindFunction" title="GstTypeFindFunction ()"><span class="type">GstTypeFindFunction</span></a> may supply different suggestions | 
 | in one call. It is up to the caller of the <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindFunction" title="GstTypeFindFunction ()"><span class="type">GstTypeFindFunction</span></a> to interpret | 
 | these values.</p> | 
 | <p>This function is similar to <a class="link" href="gstreamer-GstTypeFind.html#gst-type-find-suggest" title="gst_type_find_suggest ()"><code class="function">gst_type_find_suggest()</code></a>, only that instead of | 
 | passing a <a class="link" href="GstCaps.html" title="GstCaps"><span class="type">GstCaps</span></a> argument you can create the caps on the fly in the same | 
 | way as you can with <a class="link" href="GstCaps.html#gst-caps-new-simple" title="gst_caps_new_simple ()"><code class="function">gst_caps_new_simple()</code></a>.</p> | 
 | <p>Make sure you terminate the list of arguments with a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> argument and that | 
 | the values passed have the correct type (in terms of width in bytes when | 
 | passed to the vararg function - this applies particularly to gdouble and | 
 | guint64 arguments).</p> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.7.5.7"></a><h4>Parameters</h4> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="150px" class="parameters_name"> | 
 | <col class="parameters_description"> | 
 | <col width="200px" class="parameters_annotations"> | 
 | </colgroup> | 
 | <tbody> | 
 | <tr> | 
 | <td class="parameter_name"><p>find</p></td> | 
 | <td class="parameter_description"><p>The <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> object the function was called with</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>probability</p></td> | 
 | <td class="parameter_description"><p>The probability in percent that the suggestion is right</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>media_type</p></td> | 
 | <td class="parameter_description"><p>the media type of the suggested caps</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>fieldname</p></td> | 
 | <td class="parameter_description"><p> first field of the suggested caps, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> | 
 | <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>...</p></td> | 
 | <td class="parameter_description"><p>additional arguments to the suggested caps in the same format as the | 
 | arguments passed to <a class="link" href="GstStructure.html#gst-structure-new" title="gst_structure_new ()"><code class="function">gst_structure_new()</code></a> (ie. triplets of field name, | 
 | field GType and field value)</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | </tbody> | 
 | </table></div> | 
 | </div> | 
 | </div> | 
 | <hr> | 
 | <div class="refsect2"> | 
 | <a name="gst-type-find-get-length"></a><h3>gst_type_find_get_length ()</h3> | 
 | <pre class="programlisting"><span class="returnvalue">guint64</span> | 
 | gst_type_find_get_length (<em class="parameter"><code><a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> *find</code></em>);</pre> | 
 | <p>Get the length of the data stream.</p> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.7.6.5"></a><h4>Parameters</h4> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="150px" class="parameters_name"> | 
 | <col class="parameters_description"> | 
 | <col width="200px" class="parameters_annotations"> | 
 | </colgroup> | 
 | <tbody><tr> | 
 | <td class="parameter_name"><p>find</p></td> | 
 | <td class="parameter_description"><p>The <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFind" title="struct GstTypeFind"><span class="type">GstTypeFind</span></a> the function was called with</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr></tbody> | 
 | </table></div> | 
 | </div> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.7.6.6"></a><h4>Returns</h4> | 
 | <p> The length of the data stream, or 0 if it is not available.</p> | 
 | <p></p> | 
 | </div> | 
 | </div> | 
 | <hr> | 
 | <div class="refsect2"> | 
 | <a name="gst-type-find-register"></a><h3>gst_type_find_register ()</h3> | 
 | <pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> | 
 | gst_type_find_register (<em class="parameter"><code><a class="link" href="GstPlugin.html" title="GstPlugin"><span class="type">GstPlugin</span></a> *plugin</code></em>, | 
 |                         <em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, | 
 |                         <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> rank</code></em>, | 
 |                         <em class="parameter"><code><a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindFunction" title="GstTypeFindFunction ()"><span class="type">GstTypeFindFunction</span></a> func</code></em>, | 
 |                         <em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *extensions</code></em>, | 
 |                         <em class="parameter"><code><a class="link" href="GstCaps.html" title="GstCaps"><span class="type">GstCaps</span></a> *possible_caps</code></em>, | 
 |                         <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>, | 
 |                         <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> data_notify</code></em>);</pre> | 
 | <p>Registers a new typefind function to be used for typefinding. After | 
 | registering this function will be available for typefinding. | 
 | This function is typically called during an element's plugin initialization.</p> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.7.7.5"></a><h4>Parameters</h4> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="150px" class="parameters_name"> | 
 | <col class="parameters_description"> | 
 | <col width="200px" class="parameters_annotations"> | 
 | </colgroup> | 
 | <tbody> | 
 | <tr> | 
 | <td class="parameter_name"><p>plugin</p></td> | 
 | <td class="parameter_description"><p> A <a class="link" href="GstPlugin.html" title="GstPlugin"><span class="type">GstPlugin</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for a static typefind function. </p></td> | 
 | <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>name</p></td> | 
 | <td class="parameter_description"><p>The name for registering</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>rank</p></td> | 
 | <td class="parameter_description"><p>The rank (or importance) of this typefind function</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>func</p></td> | 
 | <td class="parameter_description"><p>The <a class="link" href="gstreamer-GstTypeFind.html#GstTypeFindFunction" title="GstTypeFindFunction ()"><span class="type">GstTypeFindFunction</span></a> to use</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>extensions</p></td> | 
 | <td class="parameter_description"><p> Optional comma-separated list of extensions | 
 | that could belong to this type. </p></td> | 
 | <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>possible_caps</p></td> | 
 | <td class="parameter_description"><p>Optionally the caps that could be returned when typefinding | 
 | succeeds</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>data</p></td> | 
 | <td class="parameter_description"><p>Optional user data. This user data must be available until the plugin | 
 | is unloaded.</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="parameter_name"><p>data_notify</p></td> | 
 | <td class="parameter_description"><p>a <a href="https://developer.gnome.org/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> that will be called on <em class="parameter"><code>data</code></em> | 
 | when the plugin | 
 | is unloaded.</p></td> | 
 | <td class="parameter_annotations"> </td> | 
 | </tr> | 
 | </tbody> | 
 | </table></div> | 
 | </div> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.7.7.6"></a><h4>Returns</h4> | 
 | <p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p> | 
 | <p></p> | 
 | </div> | 
 | </div> | 
 | </div> | 
 | <div class="refsect1"> | 
 | <a name="gstreamer-GstTypeFind.other_details"></a><h2>Types and Values</h2> | 
 | <div class="refsect2"> | 
 | <a name="GstTypeFind"></a><h3>struct GstTypeFind</h3> | 
 | <pre class="programlisting">struct GstTypeFind { | 
 |   /* private to the caller of the typefind function */ | 
 |   const guint8 *  (* peek)       (gpointer         data, | 
 |                                   gint64           offset, | 
 |                                   guint            size); | 
 |  | 
 |   void            (* suggest)    (gpointer         data, | 
 |                                   guint            probability, | 
 |                                   GstCaps         *caps); | 
 |  | 
 |   gpointer         data; | 
 |  | 
 |   /* optional */ | 
 |   guint64         (* get_length) (gpointer data); | 
 | }; | 
 | </pre> | 
 | <p>Object that stores typefind callbacks. To use with <a class="link" href="GstTypeFindFactory.html" title="GstTypeFindFactory"><span class="type">GstTypeFindFactory</span></a>.</p> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.8.2.5"></a><h4>Members</h4> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="300px" class="struct_members_name"> | 
 | <col class="struct_members_description"> | 
 | <col width="200px" class="struct_members_annotations"> | 
 | </colgroup> | 
 | <tbody> | 
 | <tr> | 
 | <td class="struct_member_name"><p><em class="structfield"><code><a name="GstTypeFind.peek"></a>peek</code></em> ()</p></td> | 
 | <td class="struct_member_description"><p>Method to peek data.</p></td> | 
 | <td class="struct_member_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="struct_member_name"><p><em class="structfield"><code><a name="GstTypeFind.suggest"></a>suggest</code></em> ()</p></td> | 
 | <td class="struct_member_description"><p>Method to suggest <a class="link" href="GstCaps.html" title="GstCaps"><span class="type">GstCaps</span></a> with a given probability.</p></td> | 
 | <td class="struct_member_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="struct_member_name"><p><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="GstTypeFind.data"></a>data</code></em>;</p></td> | 
 | <td class="struct_member_description"><p>The data used by the caller of the typefinding function.</p></td> | 
 | <td class="struct_member_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="struct_member_name"><p><em class="structfield"><code><a name="GstTypeFind.get-length"></a>get_length</code></em> ()</p></td> | 
 | <td class="struct_member_description"><p>Returns the length of current data.</p></td> | 
 | <td class="struct_member_annotations"> </td> | 
 | </tr> | 
 | </tbody> | 
 | </table></div> | 
 | </div> | 
 | </div> | 
 | <hr> | 
 | <div class="refsect2"> | 
 | <a name="GstTypeFindProbability"></a><h3>enum GstTypeFindProbability</h3> | 
 | <p>The probability of the typefind function. Higher values have more certainty | 
 | in doing a reliable typefind.</p> | 
 | <div class="refsect3"> | 
 | <a name="id-1.3.53.8.3.4"></a><h4>Members</h4> | 
 | <div class="informaltable"><table width="100%" border="0"> | 
 | <colgroup> | 
 | <col width="300px" class="enum_members_name"> | 
 | <col class="enum_members_description"> | 
 | <col width="200px" class="enum_members_annotations"> | 
 | </colgroup> | 
 | <tbody> | 
 | <tr> | 
 | <td class="enum_member_name"><p><a name="GST-TYPE-FIND-NONE:CAPS"></a>GST_TYPE_FIND_NONE</p></td> | 
 | <td class="enum_member_description"> | 
 | <p>type undetected.</p> | 
 | </td> | 
 | <td class="enum_member_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="enum_member_name"><p><a name="GST-TYPE-FIND-MINIMUM:CAPS"></a>GST_TYPE_FIND_MINIMUM</p></td> | 
 | <td class="enum_member_description"> | 
 | <p>unlikely typefind.</p> | 
 | </td> | 
 | <td class="enum_member_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="enum_member_name"><p><a name="GST-TYPE-FIND-POSSIBLE:CAPS"></a>GST_TYPE_FIND_POSSIBLE</p></td> | 
 | <td class="enum_member_description"> | 
 | <p>possible type detected.</p> | 
 | </td> | 
 | <td class="enum_member_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="enum_member_name"><p><a name="GST-TYPE-FIND-LIKELY:CAPS"></a>GST_TYPE_FIND_LIKELY</p></td> | 
 | <td class="enum_member_description"> | 
 | <p>likely a type was detected.</p> | 
 | </td> | 
 | <td class="enum_member_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="enum_member_name"><p><a name="GST-TYPE-FIND-NEARLY-CERTAIN:CAPS"></a>GST_TYPE_FIND_NEARLY_CERTAIN</p></td> | 
 | <td class="enum_member_description"> | 
 | <p>nearly certain that a type was detected.</p> | 
 | </td> | 
 | <td class="enum_member_annotations"> </td> | 
 | </tr> | 
 | <tr> | 
 | <td class="enum_member_name"><p><a name="GST-TYPE-FIND-MAXIMUM:CAPS"></a>GST_TYPE_FIND_MAXIMUM</p></td> | 
 | <td class="enum_member_description"> | 
 | <p>very certain a type was detected.</p> | 
 | </td> | 
 | <td class="enum_member_annotations"> </td> | 
 | </tr> | 
 | </tbody> | 
 | </table></div> | 
 | </div> | 
 | </div> | 
 | </div> | 
 | </div> | 
 | <div class="footer"> | 
 | <hr> | 
 |           Generated by GTK-Doc V1.21</div> | 
 | </body> | 
 | </html> |