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>GstGhostPad: GStreamer 1.0 Core Reference Manual</title> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="index.html" title="GStreamer 1.0 Core Reference Manual"> 8<link rel="up" href="libgstreamer.html" title="GStreamer Core Library"> 9<link rel="prev" href="gstreamer-GstFormat.html" title="GstFormat"> 10<link rel="next" href="gstreamer-GstIterator.html" title="GstIterator"> 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="#GstGhostPad.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 19 <a href="#GstGhostPad.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="libgstreamer.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 23<td><a accesskey="p" href="gstreamer-GstFormat.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 24<td><a accesskey="n" href="gstreamer-GstIterator.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="GstGhostPad"></a><div class="titlepage"></div> 28<div class="refnamediv"><table width="100%"><tr> 29<td valign="top"> 30<h2><span class="refentrytitle"><a name="GstGhostPad.top_of_page"></a>GstGhostPad</span></h2> 31<p>GstGhostPad — Pseudo link pads</p> 32</td> 33<td class="gallery_image" valign="top" align="right"></td> 34</tr></table></div> 35<div class="refsect1"> 36<a name="GstGhostPad.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="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 46</td> 47<td class="function_name"> 48<a class="link" href="GstGhostPad.html#gst-ghost-pad-new" title="gst_ghost_pad_new ()">gst_ghost_pad_new</a> <span class="c_punctuation">()</span> 49</td> 50</tr> 51<tr> 52<td class="function_type"> 53<a class="link" href="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 54</td> 55<td class="function_name"> 56<a class="link" href="GstGhostPad.html#gst-ghost-pad-new-no-target" title="gst_ghost_pad_new_no_target ()">gst_ghost_pad_new_no_target</a> <span class="c_punctuation">()</span> 57</td> 58</tr> 59<tr> 60<td class="function_type"> 61<a class="link" href="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 62</td> 63<td class="function_name"> 64<a class="link" href="GstGhostPad.html#gst-ghost-pad-new-from-template" title="gst_ghost_pad_new_from_template ()">gst_ghost_pad_new_from_template</a> <span class="c_punctuation">()</span> 65</td> 66</tr> 67<tr> 68<td class="function_type"> 69<a class="link" href="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 70</td> 71<td class="function_name"> 72<a class="link" href="GstGhostPad.html#gst-ghost-pad-new-no-target-from-template" title="gst_ghost_pad_new_no_target_from_template ()">gst_ghost_pad_new_no_target_from_template</a> <span class="c_punctuation">()</span> 73</td> 74</tr> 75<tr> 76<td class="function_type"> 77<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 78</td> 79<td class="function_name"> 80<a class="link" href="GstGhostPad.html#gst-ghost-pad-set-target" title="gst_ghost_pad_set_target ()">gst_ghost_pad_set_target</a> <span class="c_punctuation">()</span> 81</td> 82</tr> 83<tr> 84<td class="function_type"> 85<a class="link" href="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 86</td> 87<td class="function_name"> 88<a class="link" href="GstGhostPad.html#gst-ghost-pad-get-target" title="gst_ghost_pad_get_target ()">gst_ghost_pad_get_target</a> <span class="c_punctuation">()</span> 89</td> 90</tr> 91<tr> 92<td class="function_type"> 93<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 94</td> 95<td class="function_name"> 96<a class="link" href="GstGhostPad.html#gst-ghost-pad-construct" title="gst_ghost_pad_construct ()">gst_ghost_pad_construct</a> <span class="c_punctuation">()</span> 97</td> 98</tr> 99<tr> 100<td class="function_type"> 101<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 102</td> 103<td class="function_name"> 104<a class="link" href="GstGhostPad.html#gst-ghost-pad-activate-mode-default" title="gst_ghost_pad_activate_mode_default ()">gst_ghost_pad_activate_mode_default</a> <span class="c_punctuation">()</span> 105</td> 106</tr> 107<tr> 108<td class="function_type"> 109<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 110</td> 111<td class="function_name"> 112<a class="link" href="GstGhostPad.html#gst-ghost-pad-internal-activate-mode-default" title="gst_ghost_pad_internal_activate_mode_default ()">gst_ghost_pad_internal_activate_mode_default</a> <span class="c_punctuation">()</span> 113</td> 114</tr> 115<tr> 116<td class="function_type"> 117<a class="link" href="GstGhostPad.html#GstProxyPad"><span class="returnvalue">GstProxyPad</span></a> * 118</td> 119<td class="function_name"> 120<a class="link" href="GstGhostPad.html#gst-proxy-pad-get-internal" title="gst_proxy_pad_get_internal ()">gst_proxy_pad_get_internal</a> <span class="c_punctuation">()</span> 121</td> 122</tr> 123<tr> 124<td class="function_type"> 125<a class="link" href="gstreamer-GstIterator.html#GstIterator" title="struct GstIterator"><span class="returnvalue">GstIterator</span></a> * 126</td> 127<td class="function_name"> 128<a class="link" href="GstGhostPad.html#gst-proxy-pad-iterate-internal-links-default" title="gst_proxy_pad_iterate_internal_links_default ()">gst_proxy_pad_iterate_internal_links_default</a> <span class="c_punctuation">()</span> 129</td> 130</tr> 131<tr> 132<td class="function_type"> 133<a class="link" href="GstPad.html#GstFlowReturn" title="enum GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a> 134</td> 135<td class="function_name"> 136<a class="link" href="GstGhostPad.html#gst-proxy-pad-chain-default" title="gst_proxy_pad_chain_default ()">gst_proxy_pad_chain_default</a> <span class="c_punctuation">()</span> 137</td> 138</tr> 139<tr> 140<td class="function_type"> 141<a class="link" href="GstPad.html#GstFlowReturn" title="enum GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a> 142</td> 143<td class="function_name"> 144<a class="link" href="GstGhostPad.html#gst-proxy-pad-chain-list-default" title="gst_proxy_pad_chain_list_default ()">gst_proxy_pad_chain_list_default</a> <span class="c_punctuation">()</span> 145</td> 146</tr> 147<tr> 148<td class="function_type"> 149<a class="link" href="GstPad.html#GstFlowReturn" title="enum GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a> 150</td> 151<td class="function_name"> 152<a class="link" href="GstGhostPad.html#gst-proxy-pad-getrange-default" title="gst_proxy_pad_getrange_default ()">gst_proxy_pad_getrange_default</a> <span class="c_punctuation">()</span> 153</td> 154</tr> 155</tbody> 156</table></div> 157</div> 158<a name="GstProxyPad"></a><div class="refsect1"> 159<a name="GstGhostPad.other"></a><h2>Types and Values</h2> 160<div class="informaltable"><table class="informaltable" width="100%" border="0"> 161<colgroup> 162<col width="150px" class="name"> 163<col class="description"> 164</colgroup> 165<tbody> 166<tr> 167<td class="datatype_keyword">struct</td> 168<td class="function_name"><a class="link" href="GstGhostPad.html#GstProxyPad-struct" title="struct GstProxyPad">GstProxyPad</a></td> 169</tr> 170<tr> 171<td class="datatype_keyword">struct</td> 172<td class="function_name"><a class="link" href="GstGhostPad.html#GstGhostPad-struct" title="struct GstGhostPad">GstGhostPad</a></td> 173</tr> 174</tbody> 175</table></div> 176</div> 177<div class="refsect1"> 178<a name="GstGhostPad.object-hierarchy"></a><h2>Object Hierarchy</h2> 179<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> 180 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> 181 <span class="lineart">╰──</span> <a class="link" href="GstObject.html" title="GstObject">GstObject</a> 182 <span class="lineart">╰──</span> <a class="link" href="GstPad.html" title="GstPad">GstPad</a> 183 <span class="lineart">╰──</span> GstProxyPad 184 <span class="lineart">╰──</span> GstGhostPad 185</pre> 186</div> 187<div class="refsect1"> 188<a name="GstGhostPad.includes"></a><h2>Includes</h2> 189<pre class="synopsis">#include <gst/gst.h> 190</pre> 191</div> 192<div class="refsect1"> 193<a name="GstGhostPad.description"></a><h2>Description</h2> 194<p>GhostPads are useful when organizing pipelines with <a class="link" href="GstBin.html" title="GstBin"><span class="type">GstBin</span></a> like elements. 195The idea here is to create hierarchical element graphs. The bin element 196contains a sub-graph. Now one would like to treat the bin-element like any 197other <a class="link" href="GstElement.html" title="GstElement"><span class="type">GstElement</span></a>. This is where GhostPads come into play. A GhostPad acts as 198a proxy for another pad. Thus the bin can have sink and source ghost-pads 199that are associated with sink and source pads of the child elements.</p> 200<p>If the target pad is known at creation time, <a class="link" href="GstGhostPad.html#gst-ghost-pad-new" title="gst_ghost_pad_new ()"><code class="function">gst_ghost_pad_new()</code></a> is the 201function to use to get a ghost-pad. Otherwise one can use <a class="link" href="GstGhostPad.html#gst-ghost-pad-new-no-target" title="gst_ghost_pad_new_no_target ()"><code class="function">gst_ghost_pad_new_no_target()</code></a> 202to create the ghost-pad and use <a class="link" href="GstGhostPad.html#gst-ghost-pad-set-target" title="gst_ghost_pad_set_target ()"><code class="function">gst_ghost_pad_set_target()</code></a> to establish the 203association later on.</p> 204<p>Note that GhostPads add overhead to the data processing of a pipeline.</p> 205</div> 206<div class="refsect1"> 207<a name="GstGhostPad.functions_details"></a><h2>Functions</h2> 208<div class="refsect2"> 209<a name="gst-ghost-pad-new"></a><h3>gst_ghost_pad_new ()</h3> 210<pre class="programlisting"><a class="link" href="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 211gst_ghost_pad_new (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, 212 <em class="parameter"><code><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> *target</code></em>);</pre> 213<p>Create a new ghostpad with <em class="parameter"><code>target</code></em> 214 as the target. The direction will be taken 215from the target pad. <em class="parameter"><code>target</code></em> 216 must be unlinked.</p> 217<p>Will ref the target.</p> 218<div class="refsect3"> 219<a name="gst-ghost-pad-new.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> 227<tr> 228<td class="parameter_name"><p>name</p></td> 229<td class="parameter_description"><p>the name of the new pad, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to assign a default name. </p></td> 230<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> 231</tr> 232<tr> 233<td class="parameter_name"><p>target</p></td> 234<td class="parameter_description"><p>the pad to ghost. </p></td> 235<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> 236</tr> 237</tbody> 238</table></div> 239</div> 240<div class="refsect3"> 241<a name="gst-ghost-pad-new.returns"></a><h4>Returns</h4> 242<p>a new <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in 243case of an error. </p> 244<p><span class="annotation">[<acronym title="Alias for transfer none, used for objects with floating refs."><span class="acronym">transfer floating</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> 245</div> 246</div> 247<hr> 248<div class="refsect2"> 249<a name="gst-ghost-pad-new-no-target"></a><h3>gst_ghost_pad_new_no_target ()</h3> 250<pre class="programlisting"><a class="link" href="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 251gst_ghost_pad_new_no_target (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, 252 <em class="parameter"><code><a class="link" href="GstPad.html#GstPadDirection" title="enum GstPadDirection"><span class="type">GstPadDirection</span></a> dir</code></em>);</pre> 253<p>Create a new ghostpad without a target with the given direction. 254A target can be set on the ghostpad later with the 255<a class="link" href="GstGhostPad.html#gst-ghost-pad-set-target" title="gst_ghost_pad_set_target ()"><code class="function">gst_ghost_pad_set_target()</code></a> function.</p> 256<p>The created ghostpad will not have a padtemplate.</p> 257<div class="refsect3"> 258<a name="gst-ghost-pad-new-no-target.parameters"></a><h4>Parameters</h4> 259<div class="informaltable"><table class="informaltable" width="100%" border="0"> 260<colgroup> 261<col width="150px" class="parameters_name"> 262<col class="parameters_description"> 263<col width="200px" class="parameters_annotations"> 264</colgroup> 265<tbody> 266<tr> 267<td class="parameter_name"><p>name</p></td> 268<td class="parameter_description"><p>the name of the new pad, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to assign a default name. </p></td> 269<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> 270</tr> 271<tr> 272<td class="parameter_name"><p>dir</p></td> 273<td class="parameter_description"><p>the direction of the ghostpad</p></td> 274<td class="parameter_annotations"> </td> 275</tr> 276</tbody> 277</table></div> 278</div> 279<div class="refsect3"> 280<a name="gst-ghost-pad-new-no-target.returns"></a><h4>Returns</h4> 281<p>a new <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in 282case of an error. </p> 283<p><span class="annotation">[<acronym title="Alias for transfer none, used for objects with floating refs."><span class="acronym">transfer floating</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> 284</div> 285</div> 286<hr> 287<div class="refsect2"> 288<a name="gst-ghost-pad-new-from-template"></a><h3>gst_ghost_pad_new_from_template ()</h3> 289<pre class="programlisting"><a class="link" href="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 290gst_ghost_pad_new_from_template (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, 291 <em class="parameter"><code><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> *target</code></em>, 292 <em class="parameter"><code><a class="link" href="GstPadTemplate.html" title="GstPadTemplate"><span class="type">GstPadTemplate</span></a> *templ</code></em>);</pre> 293<p>Create a new ghostpad with <em class="parameter"><code>target</code></em> 294 as the target. The direction will be taken 295from the target pad. The template used on the ghostpad will be <em class="parameter"><code>template</code></em> 296.</p> 297<p>Will ref the target.</p> 298<div class="refsect3"> 299<a name="gst-ghost-pad-new-from-template.parameters"></a><h4>Parameters</h4> 300<div class="informaltable"><table class="informaltable" width="100%" border="0"> 301<colgroup> 302<col width="150px" class="parameters_name"> 303<col class="parameters_description"> 304<col width="200px" class="parameters_annotations"> 305</colgroup> 306<tbody> 307<tr> 308<td class="parameter_name"><p>name</p></td> 309<td class="parameter_description"><p>the name of the new pad, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to assign a default name. </p></td> 310<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> 311</tr> 312<tr> 313<td class="parameter_name"><p>target</p></td> 314<td class="parameter_description"><p>the pad to ghost. </p></td> 315<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> 316</tr> 317<tr> 318<td class="parameter_name"><p>templ</p></td> 319<td class="parameter_description"><p>the <a class="link" href="GstPadTemplate.html" title="GstPadTemplate"><span class="type">GstPadTemplate</span></a> to use on the ghostpad. </p></td> 320<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> 321</tr> 322</tbody> 323</table></div> 324</div> 325<div class="refsect3"> 326<a name="gst-ghost-pad-new-from-template.returns"></a><h4>Returns</h4> 327<p>a new <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in 328case of an error. </p> 329<p><span class="annotation">[<acronym title="Alias for transfer none, used for objects with floating refs."><span class="acronym">transfer floating</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> 330</div> 331</div> 332<hr> 333<div class="refsect2"> 334<a name="gst-ghost-pad-new-no-target-from-template"></a><h3>gst_ghost_pad_new_no_target_from_template ()</h3> 335<pre class="programlisting"><a class="link" href="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 336gst_ghost_pad_new_no_target_from_template 337 (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>, 338 <em class="parameter"><code><a class="link" href="GstPadTemplate.html" title="GstPadTemplate"><span class="type">GstPadTemplate</span></a> *templ</code></em>);</pre> 339<p>Create a new ghostpad based on <em class="parameter"><code>templ</code></em> 340, without setting a target. The 341direction will be taken from the <em class="parameter"><code>templ</code></em> 342.</p> 343<div class="refsect3"> 344<a name="gst-ghost-pad-new-no-target-from-template.parameters"></a><h4>Parameters</h4> 345<div class="informaltable"><table class="informaltable" width="100%" border="0"> 346<colgroup> 347<col width="150px" class="parameters_name"> 348<col class="parameters_description"> 349<col width="200px" class="parameters_annotations"> 350</colgroup> 351<tbody> 352<tr> 353<td class="parameter_name"><p>name</p></td> 354<td class="parameter_description"><p>the name of the new pad, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to assign a default name. </p></td> 355<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> 356</tr> 357<tr> 358<td class="parameter_name"><p>templ</p></td> 359<td class="parameter_description"><p>the <a class="link" href="GstPadTemplate.html" title="GstPadTemplate"><span class="type">GstPadTemplate</span></a> to create the ghostpad from. </p></td> 360<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> 361</tr> 362</tbody> 363</table></div> 364</div> 365<div class="refsect3"> 366<a name="gst-ghost-pad-new-no-target-from-template.returns"></a><h4>Returns</h4> 367<p>a new <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in 368case of an error. </p> 369<p><span class="annotation">[<acronym title="Alias for transfer none, used for objects with floating refs."><span class="acronym">transfer floating</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> 370</div> 371</div> 372<hr> 373<div class="refsect2"> 374<a name="gst-ghost-pad-set-target"></a><h3>gst_ghost_pad_set_target ()</h3> 375<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 376gst_ghost_pad_set_target (<em class="parameter"><code><a class="link" href="GstGhostPad.html" title="GstGhostPad"><span class="type">GstGhostPad</span></a> *gpad</code></em>, 377 <em class="parameter"><code><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> *newtarget</code></em>);</pre> 378<p>Set the new target of the ghostpad <em class="parameter"><code>gpad</code></em> 379. Any existing target 380is unlinked and links to the new target are established. if <em class="parameter"><code>newtarget</code></em> 381 is 382<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> the target will be cleared.</p> 383<div class="refsect3"> 384<a name="gst-ghost-pad-set-target.parameters"></a><h4>Parameters</h4> 385<div class="informaltable"><table class="informaltable" width="100%" border="0"> 386<colgroup> 387<col width="150px" class="parameters_name"> 388<col class="parameters_description"> 389<col width="200px" class="parameters_annotations"> 390</colgroup> 391<tbody> 392<tr> 393<td class="parameter_name"><p>gpad</p></td> 394<td class="parameter_description"><p>the <a class="link" href="GstGhostPad.html" title="GstGhostPad"><span class="type">GstGhostPad</span></a></p></td> 395<td class="parameter_annotations"> </td> 396</tr> 397<tr> 398<td class="parameter_name"><p>newtarget</p></td> 399<td class="parameter_description"><p>the new pad target. </p></td> 400<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> 401</tr> 402</tbody> 403</table></div> 404</div> 405<div class="refsect3"> 406<a name="gst-ghost-pad-set-target.returns"></a><h4>Returns</h4> 407<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the new target could be set. This function 408can return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> when the internal pads could not be linked.</p> 409</div> 410</div> 411<hr> 412<div class="refsect2"> 413<a name="gst-ghost-pad-get-target"></a><h3>gst_ghost_pad_get_target ()</h3> 414<pre class="programlisting"><a class="link" href="GstPad.html" title="GstPad"><span class="returnvalue">GstPad</span></a> * 415gst_ghost_pad_get_target (<em class="parameter"><code><a class="link" href="GstGhostPad.html" title="GstGhostPad"><span class="type">GstGhostPad</span></a> *gpad</code></em>);</pre> 416<p>Get the target pad of <em class="parameter"><code>gpad</code></em> 417. Unref target pad after usage.</p> 418<div class="refsect3"> 419<a name="gst-ghost-pad-get-target.parameters"></a><h4>Parameters</h4> 420<div class="informaltable"><table class="informaltable" width="100%" border="0"> 421<colgroup> 422<col width="150px" class="parameters_name"> 423<col class="parameters_description"> 424<col width="200px" class="parameters_annotations"> 425</colgroup> 426<tbody><tr> 427<td class="parameter_name"><p>gpad</p></td> 428<td class="parameter_description"><p>the <a class="link" href="GstGhostPad.html" title="GstGhostPad"><span class="type">GstGhostPad</span></a></p></td> 429<td class="parameter_annotations"> </td> 430</tr></tbody> 431</table></div> 432</div> 433<div class="refsect3"> 434<a name="gst-ghost-pad-get-target.returns"></a><h4>Returns</h4> 435<p>the target <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, can be 436<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the ghostpad has no target set. Unref target pad after 437usage. </p> 438<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> 439</div> 440</div> 441<hr> 442<div class="refsect2"> 443<a name="gst-ghost-pad-construct"></a><h3>gst_ghost_pad_construct ()</h3> 444<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 445gst_ghost_pad_construct (<em class="parameter"><code><a class="link" href="GstGhostPad.html" title="GstGhostPad"><span class="type">GstGhostPad</span></a> *gpad</code></em>);</pre> 446<p>Finish initialization of a newly allocated ghost pad.</p> 447<p>This function is most useful in language bindings and when subclassing 448<a class="link" href="GstGhostPad.html" title="GstGhostPad"><span class="type">GstGhostPad</span></a>; plugin and application developers normally will not call this 449function. Call this function directly after a call to g_object_new 450(GST_TYPE_GHOST_PAD, "direction", <em class="parameter"><code>dir</code></em> 451, ..., NULL).</p> 452<div class="refsect3"> 453<a name="gst-ghost-pad-construct.parameters"></a><h4>Parameters</h4> 454<div class="informaltable"><table class="informaltable" width="100%" border="0"> 455<colgroup> 456<col width="150px" class="parameters_name"> 457<col class="parameters_description"> 458<col width="200px" class="parameters_annotations"> 459</colgroup> 460<tbody><tr> 461<td class="parameter_name"><p>gpad</p></td> 462<td class="parameter_description"><p>the newly allocated ghost pad</p></td> 463<td class="parameter_annotations"> </td> 464</tr></tbody> 465</table></div> 466</div> 467<div class="refsect3"> 468<a name="gst-ghost-pad-construct.returns"></a><h4>Returns</h4> 469<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the construction succeeds, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p> 470</div> 471</div> 472<hr> 473<div class="refsect2"> 474<a name="gst-ghost-pad-activate-mode-default"></a><h3>gst_ghost_pad_activate_mode_default ()</h3> 475<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 476gst_ghost_pad_activate_mode_default (<em class="parameter"><code><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> *pad</code></em>, 477 <em class="parameter"><code><a class="link" href="GstObject.html" title="GstObject"><span class="type">GstObject</span></a> *parent</code></em>, 478 <em class="parameter"><code><a class="link" href="GstPad.html#GstPadMode" title="enum GstPadMode"><span class="type">GstPadMode</span></a> mode</code></em>, 479 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> active</code></em>);</pre> 480<p>Invoke the default activate mode function of a ghost pad.</p> 481<div class="refsect3"> 482<a name="gst-ghost-pad-activate-mode-default.parameters"></a><h4>Parameters</h4> 483<div class="informaltable"><table class="informaltable" width="100%" border="0"> 484<colgroup> 485<col width="150px" class="parameters_name"> 486<col class="parameters_description"> 487<col width="200px" class="parameters_annotations"> 488</colgroup> 489<tbody> 490<tr> 491<td class="parameter_name"><p>pad</p></td> 492<td class="parameter_description"><p>the <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> to activate or deactivate.</p></td> 493<td class="parameter_annotations"> </td> 494</tr> 495<tr> 496<td class="parameter_name"><p>parent</p></td> 497<td class="parameter_description"><p>the parent of <em class="parameter"><code>pad</code></em> 498or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 499<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> 500</tr> 501<tr> 502<td class="parameter_name"><p>mode</p></td> 503<td class="parameter_description"><p>the requested activation mode</p></td> 504<td class="parameter_annotations"> </td> 505</tr> 506<tr> 507<td class="parameter_name"><p>active</p></td> 508<td class="parameter_description"><p>whether the pad should be active or not.</p></td> 509<td class="parameter_annotations"> </td> 510</tr> 511</tbody> 512</table></div> 513</div> 514<div class="refsect3"> 515<a name="gst-ghost-pad-activate-mode-default.returns"></a><h4>Returns</h4> 516<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful.</p> 517</div> 518</div> 519<hr> 520<div class="refsect2"> 521<a name="gst-ghost-pad-internal-activate-mode-default"></a><h3>gst_ghost_pad_internal_activate_mode_default ()</h3> 522<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> 523gst_ghost_pad_internal_activate_mode_default 524 (<em class="parameter"><code><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> *pad</code></em>, 525 <em class="parameter"><code><a class="link" href="GstObject.html" title="GstObject"><span class="type">GstObject</span></a> *parent</code></em>, 526 <em class="parameter"><code><a class="link" href="GstPad.html#GstPadMode" title="enum GstPadMode"><span class="type">GstPadMode</span></a> mode</code></em>, 527 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> active</code></em>);</pre> 528<p>Invoke the default activate mode function of a proxy pad that is 529owned by a ghost pad.</p> 530<div class="refsect3"> 531<a name="gst-ghost-pad-internal-activate-mode-default.parameters"></a><h4>Parameters</h4> 532<div class="informaltable"><table class="informaltable" width="100%" border="0"> 533<colgroup> 534<col width="150px" class="parameters_name"> 535<col class="parameters_description"> 536<col width="200px" class="parameters_annotations"> 537</colgroup> 538<tbody> 539<tr> 540<td class="parameter_name"><p>pad</p></td> 541<td class="parameter_description"><p>the <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> to activate or deactivate.</p></td> 542<td class="parameter_annotations"> </td> 543</tr> 544<tr> 545<td class="parameter_name"><p>parent</p></td> 546<td class="parameter_description"><p>the parent of <em class="parameter"><code>pad</code></em> 547or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 548<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> 549</tr> 550<tr> 551<td class="parameter_name"><p>mode</p></td> 552<td class="parameter_description"><p>the requested activation mode</p></td> 553<td class="parameter_annotations"> </td> 554</tr> 555<tr> 556<td class="parameter_name"><p>active</p></td> 557<td class="parameter_description"><p>whether the pad should be active or not.</p></td> 558<td class="parameter_annotations"> </td> 559</tr> 560</tbody> 561</table></div> 562</div> 563<div class="refsect3"> 564<a name="gst-ghost-pad-internal-activate-mode-default.returns"></a><h4>Returns</h4> 565<p> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful.</p> 566</div> 567</div> 568<hr> 569<div class="refsect2"> 570<a name="gst-proxy-pad-get-internal"></a><h3>gst_proxy_pad_get_internal ()</h3> 571<pre class="programlisting"><a class="link" href="GstGhostPad.html#GstProxyPad"><span class="returnvalue">GstProxyPad</span></a> * 572gst_proxy_pad_get_internal (<em class="parameter"><code><a class="link" href="GstGhostPad.html#GstProxyPad"><span class="type">GstProxyPad</span></a> *pad</code></em>);</pre> 573<p>Get the internal pad of <em class="parameter"><code>pad</code></em> 574. Unref target pad after usage.</p> 575<p>The internal pad of a <a class="link" href="GstGhostPad.html" title="GstGhostPad"><span class="type">GstGhostPad</span></a> is the internally used 576pad of opposite direction, which is used to link to the target.</p> 577<div class="refsect3"> 578<a name="gst-proxy-pad-get-internal.parameters"></a><h4>Parameters</h4> 579<div class="informaltable"><table class="informaltable" width="100%" border="0"> 580<colgroup> 581<col width="150px" class="parameters_name"> 582<col class="parameters_description"> 583<col width="200px" class="parameters_annotations"> 584</colgroup> 585<tbody><tr> 586<td class="parameter_name"><p>pad</p></td> 587<td class="parameter_description"><p>the <a class="link" href="GstGhostPad.html#GstProxyPad"><span class="type">GstProxyPad</span></a></p></td> 588<td class="parameter_annotations"> </td> 589</tr></tbody> 590</table></div> 591</div> 592<div class="refsect3"> 593<a name="gst-proxy-pad-get-internal.returns"></a><h4>Returns</h4> 594<p>the target <a class="link" href="GstGhostPad.html#GstProxyPad"><span class="type">GstProxyPad</span></a>, can 595be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Unref target pad after usage. </p> 596<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p> 597</div> 598</div> 599<hr> 600<div class="refsect2"> 601<a name="gst-proxy-pad-iterate-internal-links-default"></a><h3>gst_proxy_pad_iterate_internal_links_default ()</h3> 602<pre class="programlisting"><a class="link" href="gstreamer-GstIterator.html#GstIterator" title="struct GstIterator"><span class="returnvalue">GstIterator</span></a> * 603gst_proxy_pad_iterate_internal_links_default 604 (<em class="parameter"><code><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> *pad</code></em>, 605 <em class="parameter"><code><a class="link" href="GstObject.html" title="GstObject"><span class="type">GstObject</span></a> *parent</code></em>);</pre> 606<p>Invoke the default iterate internal links function of the proxy pad.</p> 607<div class="refsect3"> 608<a name="gst-proxy-pad-iterate-internal-links-default.parameters"></a><h4>Parameters</h4> 609<div class="informaltable"><table class="informaltable" width="100%" border="0"> 610<colgroup> 611<col width="150px" class="parameters_name"> 612<col class="parameters_description"> 613<col width="200px" class="parameters_annotations"> 614</colgroup> 615<tbody> 616<tr> 617<td class="parameter_name"><p>pad</p></td> 618<td class="parameter_description"><p>the <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> to get the internal links of.</p></td> 619<td class="parameter_annotations"> </td> 620</tr> 621<tr> 622<td class="parameter_name"><p>parent</p></td> 623<td class="parameter_description"><p>the parent of <em class="parameter"><code>pad</code></em> 624or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 625<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> 626</tr> 627</tbody> 628</table></div> 629</div> 630<div class="refsect3"> 631<a name="gst-proxy-pad-iterate-internal-links-default.returns"></a><h4>Returns</h4> 632<p>a <a class="link" href="gstreamer-GstIterator.html#GstIterator" title="struct GstIterator"><span class="type">GstIterator</span></a> of <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>pad</code></em> 633has no parent. Unref each returned pad with <a class="link" href="GstObject.html#gst-object-unref" title="gst_object_unref ()"><code class="function">gst_object_unref()</code></a>. </p> 634<p><span class="annotation">[<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> 635</div> 636</div> 637<hr> 638<div class="refsect2"> 639<a name="gst-proxy-pad-chain-default"></a><h3>gst_proxy_pad_chain_default ()</h3> 640<pre class="programlisting"><a class="link" href="GstPad.html#GstFlowReturn" title="enum GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a> 641gst_proxy_pad_chain_default (<em class="parameter"><code><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> *pad</code></em>, 642 <em class="parameter"><code><a class="link" href="GstObject.html" title="GstObject"><span class="type">GstObject</span></a> *parent</code></em>, 643 <em class="parameter"><code><a class="link" href="GstBuffer.html" title="GstBuffer"><span class="type">GstBuffer</span></a> *buffer</code></em>);</pre> 644<p>Invoke the default chain function of the proxy pad.</p> 645<div class="refsect3"> 646<a name="gst-proxy-pad-chain-default.parameters"></a><h4>Parameters</h4> 647<div class="informaltable"><table class="informaltable" width="100%" border="0"> 648<colgroup> 649<col width="150px" class="parameters_name"> 650<col class="parameters_description"> 651<col width="200px" class="parameters_annotations"> 652</colgroup> 653<tbody> 654<tr> 655<td class="parameter_name"><p>pad</p></td> 656<td class="parameter_description"><p>a sink <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, returns GST_FLOW_ERROR if not.</p></td> 657<td class="parameter_annotations"> </td> 658</tr> 659<tr> 660<td class="parameter_name"><p>parent</p></td> 661<td class="parameter_description"><p>the parent of <em class="parameter"><code>pad</code></em> 662or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 663<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> 664</tr> 665<tr> 666<td class="parameter_name"><p>buffer</p></td> 667<td class="parameter_description"><p>the <a class="link" href="GstBuffer.html" title="GstBuffer"><span class="type">GstBuffer</span></a> to send, return GST_FLOW_ERROR 668if not. </p></td> 669<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> 670</tr> 671</tbody> 672</table></div> 673</div> 674<div class="refsect3"> 675<a name="gst-proxy-pad-chain-default.returns"></a><h4>Returns</h4> 676<p> a <a class="link" href="GstPad.html#GstFlowReturn" title="enum GstFlowReturn"><span class="type">GstFlowReturn</span></a> from the pad.</p> 677</div> 678</div> 679<hr> 680<div class="refsect2"> 681<a name="gst-proxy-pad-chain-list-default"></a><h3>gst_proxy_pad_chain_list_default ()</h3> 682<pre class="programlisting"><a class="link" href="GstPad.html#GstFlowReturn" title="enum GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a> 683gst_proxy_pad_chain_list_default (<em class="parameter"><code><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> *pad</code></em>, 684 <em class="parameter"><code><a class="link" href="GstObject.html" title="GstObject"><span class="type">GstObject</span></a> *parent</code></em>, 685 <em class="parameter"><code><a class="link" href="GstBufferList.html" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);</pre> 686<p>Invoke the default chain list function of the proxy pad.</p> 687<div class="refsect3"> 688<a name="gst-proxy-pad-chain-list-default.parameters"></a><h4>Parameters</h4> 689<div class="informaltable"><table class="informaltable" width="100%" border="0"> 690<colgroup> 691<col width="150px" class="parameters_name"> 692<col class="parameters_description"> 693<col width="200px" class="parameters_annotations"> 694</colgroup> 695<tbody> 696<tr> 697<td class="parameter_name"><p>pad</p></td> 698<td class="parameter_description"><p>a sink <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, returns GST_FLOW_ERROR if not.</p></td> 699<td class="parameter_annotations"> </td> 700</tr> 701<tr> 702<td class="parameter_name"><p>parent</p></td> 703<td class="parameter_description"><p>the parent of <em class="parameter"><code>pad</code></em> 704or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> 705<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> 706</tr> 707<tr> 708<td class="parameter_name"><p>list</p></td> 709<td class="parameter_description"><p>the <a class="link" href="GstBufferList.html" title="GstBufferList"><span class="type">GstBufferList</span></a> to send, return GST_FLOW_ERROR 710if not. </p></td> 711<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> 712</tr> 713</tbody> 714</table></div> 715</div> 716<div class="refsect3"> 717<a name="gst-proxy-pad-chain-list-default.returns"></a><h4>Returns</h4> 718<p> a <a class="link" href="GstPad.html#GstFlowReturn" title="enum GstFlowReturn"><span class="type">GstFlowReturn</span></a> from the pad.</p> 719</div> 720</div> 721<hr> 722<div class="refsect2"> 723<a name="gst-proxy-pad-getrange-default"></a><h3>gst_proxy_pad_getrange_default ()</h3> 724<pre class="programlisting"><a class="link" href="GstPad.html#GstFlowReturn" title="enum GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a> 725gst_proxy_pad_getrange_default (<em class="parameter"><code><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a> *pad</code></em>, 726 <em class="parameter"><code><a class="link" href="GstObject.html" title="GstObject"><span class="type">GstObject</span></a> *parent</code></em>, 727 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a> offset</code></em>, 728 <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>, 729 <em class="parameter"><code><a class="link" href="GstBuffer.html" title="GstBuffer"><span class="type">GstBuffer</span></a> **buffer</code></em>);</pre> 730<p>Invoke the default getrange function of the proxy pad.</p> 731<div class="refsect3"> 732<a name="gst-proxy-pad-getrange-default.parameters"></a><h4>Parameters</h4> 733<div class="informaltable"><table class="informaltable" width="100%" border="0"> 734<colgroup> 735<col width="150px" class="parameters_name"> 736<col class="parameters_description"> 737<col width="200px" class="parameters_annotations"> 738</colgroup> 739<tbody> 740<tr> 741<td class="parameter_name"><p>pad</p></td> 742<td class="parameter_description"><p>a src <a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, returns <a class="link" href="GstPad.html#GST-FLOW-ERROR:CAPS"><span class="type">GST_FLOW_ERROR</span></a> if not.</p></td> 743<td class="parameter_annotations"> </td> 744</tr> 745<tr> 746<td class="parameter_name"><p>parent</p></td> 747<td class="parameter_description"><p>the parent of <em class="parameter"><code>pad</code></em> 748</p></td> 749<td class="parameter_annotations"> </td> 750</tr> 751<tr> 752<td class="parameter_name"><p>offset</p></td> 753<td class="parameter_description"><p>The start offset of the buffer</p></td> 754<td class="parameter_annotations"> </td> 755</tr> 756<tr> 757<td class="parameter_name"><p>size</p></td> 758<td class="parameter_description"><p>The length of the buffer</p></td> 759<td class="parameter_annotations"> </td> 760</tr> 761<tr> 762<td class="parameter_name"><p>buffer</p></td> 763<td class="parameter_description"><p>a pointer to hold the <a class="link" href="GstBuffer.html" title="GstBuffer"><span class="type">GstBuffer</span></a>, 764returns <a class="link" href="GstPad.html#GST-FLOW-ERROR:CAPS"><span class="type">GST_FLOW_ERROR</span></a> if <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="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>]</span></td> 766</tr> 767</tbody> 768</table></div> 769</div> 770<div class="refsect3"> 771<a name="gst-proxy-pad-getrange-default.returns"></a><h4>Returns</h4> 772<p> a <a class="link" href="GstPad.html#GstFlowReturn" title="enum GstFlowReturn"><span class="type">GstFlowReturn</span></a> from the pad.</p> 773</div> 774</div> 775</div> 776<div class="refsect1"> 777<a name="GstGhostPad.other_details"></a><h2>Types and Values</h2> 778<div class="refsect2"> 779<a name="GstProxyPad-struct"></a><h3>struct GstProxyPad</h3> 780<pre class="programlisting">struct GstProxyPad;</pre> 781</div> 782<hr> 783<div class="refsect2"> 784<a name="GstGhostPad-struct"></a><h3>struct GstGhostPad</h3> 785<pre class="programlisting">struct GstGhostPad;</pre> 786<p>Opaque <a class="link" href="GstGhostPad.html" title="GstGhostPad"><span class="type">GstGhostPad</span></a> structure.</p> 787</div> 788</div> 789<div class="refsect1"> 790<a name="GstGhostPad.see-also"></a><h2>See Also</h2> 791<p><a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a></p> 792</div> 793</div> 794<div class="footer"> 795<hr>Generated by GTK-Doc V1.28</div> 796</body> 797</html>