RubyGems - gstreamer - Versions diffs - 1.1.0-x86-mingw32 - Mend

gstreamer 1.1.0-x86-mingw32

Files changed (1897) hide show

data/vendor/local/share/gtk-doc/html/gstreamer-0.10/gstreamer-GstBufferList.html ADDED Viewed

@@ -0,0 +1,1043 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GstBufferList</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
+<link rel="home" href="index.html" title="GStreamer 0.10 Core Reference Manual">
+<link rel="up" href="libgstreamer.html" title="GStreamer Core Library">
+<link rel="prev" href="gstreamer-GstBuffer.html" title="GstBuffer">
+<link rel="next" href="GstBus.html" title="GstBus">
+<meta name="generator" content="GTK-Doc V1.17 (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="2">
+<tr valign="middle">
+<td><a accesskey="p" href="gstreamer-GstBuffer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="libgstreamer.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GStreamer 0.10 Core Reference Manual</th>
+<td><a accesskey="n" href="GstBus.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#gstreamer-GstBufferList.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#gstreamer-GstBufferList.description" class="shortcut">Description</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="gstreamer-GstBufferList"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="gstreamer-GstBufferList.top_of_page"></a>GstBufferList</span></h2>
+<p>GstBufferList — Grouped scatter data buffer type for data-passing</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="gstreamer-GstBufferList.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gst/gst.h&gt;
+                    <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList">GstBufferList</a>;
+                    <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator">GstBufferListIterator</a>;
+<a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *         (<a class="link" href="gstreamer-GstBufferList.html#GstBufferListDoFunction" title="GstBufferListDoFunction ()">*GstBufferListDoFunction</a>)          (<em class="parameter"><code><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> *buffer</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
+<a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="returnvalue">GstBufferList</span></a> *     <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-new" title="gst_buffer_list_new ()">gst_buffer_list_new</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
+<a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="returnvalue">GstBufferList</span></a> *     <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-ref" title="gst_buffer_list_ref ()">gst_buffer_list_ref</a>                 (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-unref" title="gst_buffer_list_unref ()">gst_buffer_list_unref</a>               (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);
+<a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="returnvalue">GstBufferList</span></a> *     <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-copy" title="gst_buffer_list_copy ()">gst_buffer_list_copy</a>                (<em class="parameter"><code>const <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);
+#define             <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-is-writable" title="gst_buffer_list_is_writable()">gst_buffer_list_is_writable</a>         (list)
+#define             <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-make-writable" title="gst_buffer_list_make_writable()">gst_buffer_list_make_writable</a>       (list)
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-n-groups" title="gst_buffer_list_n_groups ()">gst_buffer_list_n_groups</a>            (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);
+enum                <a class="link" href="gstreamer-GstBufferList.html#GstBufferListItem" title="enum GstBufferListItem">GstBufferListItem</a>;
+<a class="link" href="gstreamer-GstBufferList.html#GstBufferListItem" title="enum GstBufferListItem"><span class="returnvalue">GstBufferListItem</span></a>   (<a class="link" href="gstreamer-GstBufferList.html#GstBufferListFunc" title="GstBufferListFunc ()">*GstBufferListFunc</a>)                (<em class="parameter"><code><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> **buffer</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> group</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> idx</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-foreach" title="gst_buffer_list_foreach ()">gst_buffer_list_foreach</a>             (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListFunc" title="GstBufferListFunc ()"><span class="type">GstBufferListFunc</span></a> func</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
+<a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-get" title="gst_buffer_list_get ()">gst_buffer_list_get</a>           (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> group</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> idx</code></em>);
+<a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="returnvalue">GstBufferListIterator</span></a> *   <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterate" title="gst_buffer_list_iterate ()">gst_buffer_list_iterate</a>       (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-free" title="gst_buffer_list_iterator_free ()">gst_buffer_list_iterator_free</a>       (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-n-buffers" title="gst_buffer_list_iterator_n_buffers ()">gst_buffer_list_iterator_n_buffers</a>  (<em class="parameter"><code>const <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-add" title="gst_buffer_list_iterator_add ()">gst_buffer_list_iterator_add</a>        (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> *buffer</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-add-group" title="gst_buffer_list_iterator_add_group ()">gst_buffer_list_iterator_add_group</a>  (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-add-list" title="gst_buffer_list_iterator_add_list ()">gst_buffer_list_iterator_add_list</a>   (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *list</code></em>);
+<a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()">gst_buffer_list_iterator_next</a> (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next-group" title="gst_buffer_list_iterator_next_group ()">gst_buffer_list_iterator_next_group</a> (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-remove" title="gst_buffer_list_iterator_remove ()">gst_buffer_list_iterator_remove</a>     (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);
+<a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-steal" title="gst_buffer_list_iterator_steal ()">gst_buffer_list_iterator_steal</a>
+                                                        (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-take" title="gst_buffer_list_iterator_take ()">gst_buffer_list_iterator_take</a>       (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> *buffer</code></em>);
+<a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-do" title="gst_buffer_list_iterator_do ()">gst_buffer_list_iterator_do</a>   (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListDoFunction" title="GstBufferListDoFunction ()"><span class="type">GstBufferListDoFunction</span></a> do_func</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
+<a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-merge-group" title="gst_buffer_list_iterator_merge_group ()">gst_buffer_list_iterator_merge_group</a>
+                                                        (<em class="parameter"><code>const <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="gstreamer-GstBufferList.description"></a><h2>Description</h2>
+<p>
+Buffer lists are units of grouped scatter/gather data transfer in
+GStreamer.
+</p>
+<p>
+Buffer lists are created with <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-new" title="gst_buffer_list_new ()"><code class="function">gst_buffer_list_new()</code></a> and filled with data
+using a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>. The iterator has no current buffer; its
+cursor position lies between buffers, immediately before the buffer that
+would be returned by <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>. After iterating to the
+end of a group the iterator must be advanced to the next group by a call to
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next-group" title="gst_buffer_list_iterator_next_group ()"><code class="function">gst_buffer_list_iterator_next_group()</code></a> before any further calls to
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> can return buffers again. The cursor position
+of a newly created iterator lies before the first group; a call to
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next-group" title="gst_buffer_list_iterator_next_group ()"><code class="function">gst_buffer_list_iterator_next_group()</code></a> is necessary before calls to
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> can return buffers.
+</p>
+<p>
+</p>
+<div class="informalfigure"><pre class="programlisting">
+     +--- group0 ----------------------+--- group1 ------------+
+     |   buffer0   buffer1   buffer2   |   buffer3   buffer4   |
+   ^   ^         ^         ^         ^   ^         ^         ^
+   Iterator positions between buffers
+  </pre></div>
+<p>
+</p>
+<p>
+The <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-remove" title="gst_buffer_list_iterator_remove ()"><code class="function">gst_buffer_list_iterator_remove()</code></a>, <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-steal" title="gst_buffer_list_iterator_steal ()"><code class="function">gst_buffer_list_iterator_steal()</code></a>,
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-take" title="gst_buffer_list_iterator_take ()"><code class="function">gst_buffer_list_iterator_take()</code></a> and <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-do" title="gst_buffer_list_iterator_do ()"><code class="function">gst_buffer_list_iterator_do()</code></a> functions
+are not defined in terms of the cursor position; they operate on the last
+element returned from <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>.
+</p>
+<p>
+The basic use pattern of creating a buffer list with an iterator is as
+follows:
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idp6861456"></a><p class="title"><b>Example 4. Creating a buffer list</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16</pre></td>
+        <td class="listing_code"><pre class="programlisting">GstBufferList <span class="gtkdoc opt">*</span>list<span class="gtkdoc opt">;</span>
+GstBufferListIterator <span class="gtkdoc opt">*</span>it<span class="gtkdoc opt">;</span>
+list <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-new">gst_buffer_list_new</a></span> <span class="gtkdoc opt">();</span>
+it <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterate">gst_buffer_list_iterate</a></span> <span class="gtkdoc opt">(</span>list<span class="gtkdoc opt">);</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-add-group">gst_buffer_list_iterator_add_group</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">);</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-add">gst_buffer_list_iterator_add</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">,</span> header1<span class="gtkdoc opt">);</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-add">gst_buffer_list_iterator_add</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">,</span> data1<span class="gtkdoc opt">);</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-add-group">gst_buffer_list_iterator_add_group</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">);</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-add">gst_buffer_list_iterator_add</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">,</span> header2<span class="gtkdoc opt">);</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-add">gst_buffer_list_iterator_add</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">,</span> data2<span class="gtkdoc opt">);</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-add-group">gst_buffer_list_iterator_add_group</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">);</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-add">gst_buffer_list_iterator_add</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">,</span> header3<span class="gtkdoc opt">);</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-add">gst_buffer_list_iterator_add</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">,</span> data3<span class="gtkdoc opt">);</span>
+<span class="gtkdoc opt">...</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-free">gst_buffer_list_iterator_free</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+<p>
+The basic use pattern of iterating over a buffer list is as follows:
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idp6864592"></a><p class="title"><b>Example 5. Iterating a buffer list</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9</pre></td>
+        <td class="listing_code"><pre class="programlisting">GstBufferListIterator <span class="gtkdoc opt">*</span>it<span class="gtkdoc opt">;</span>
+it <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterate">gst_buffer_list_iterate</a></span> <span class="gtkdoc opt">(</span>list<span class="gtkdoc opt">);</span>
+<span class="keyword">while</span> <span class="gtkdoc opt">(</span><span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-next-group">gst_buffer_list_iterator_next_group</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">)) {</span>
+  <span class="keyword">while</span> <span class="gtkdoc opt">((</span>buffer <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-next">gst_buffer_list_iterator_next</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">)) !=</span> NULL<span class="gtkdoc opt">) {</span>
+    <span class="function">do_something_with_buffer</span> <span class="gtkdoc opt">(</span>buffer<span class="gtkdoc opt">);</span>
+  <span class="gtkdoc opt">}</span>
+<span class="gtkdoc opt">}</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-free">gst_buffer_list_iterator_free</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+<p>
+The basic use pattern of modifying a buffer in a list is as follows:
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idp6976272"></a><p class="title"><b>Example 6. Modifying the data of the first buffer in a list</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15</pre></td>
+        <td class="listing_code"><pre class="programlisting">GstBufferListIterator <span class="gtkdoc opt">*</span>it<span class="gtkdoc opt">;</span>
+list <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-make-writable">gst_buffer_list_make_writable</a></span> <span class="gtkdoc opt">(</span>list<span class="gtkdoc opt">);</span>
+it <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterate">gst_buffer_list_iterate</a></span> <span class="gtkdoc opt">(</span>list<span class="gtkdoc opt">);</span>
+<span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-next-group">gst_buffer_list_iterator_next_group</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">)) {</span>
+  GstBuffer <span class="gtkdoc opt">*</span>buf
+  buf <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-next">gst_buffer_list_iterator_next</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">);</span>
+  <span class="keyword">if</span> <span class="gtkdoc opt">(</span>buf <span class="gtkdoc opt">!=</span> NULL<span class="gtkdoc opt">) {</span>
+    buf <span class="gtkdoc opt">=</span> <span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-do">gst_buffer_list_iterator_do</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">,</span>
+        <span class="gtkdoc opt">(</span>GstBufferListDoFunction<span class="gtkdoc opt">)</span> gst_mini_object_make_writable<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
+    <span class="function">modify_data</span> <span class="gtkdoc opt">(</span><span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBuffer.html#GST-BUFFER-DATA:CAPS">GST_BUFFER_DATA</a></span> <span class="gtkdoc opt">(</span>buf<span class="gtkdoc opt">));</span>
+  <span class="gtkdoc opt">}</span>
+<span class="gtkdoc opt">}</span>
+<span class="function"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBufferList.html#gst-buffer-list-iterator-free">gst_buffer_list_iterator_free</a></span> <span class="gtkdoc opt">(</span>it<span class="gtkdoc opt">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+</div>
+<div class="refsect1">
+<a name="gstreamer-GstBufferList.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GstBufferList"></a><h3>GstBufferList</h3>
+<pre class="programlisting">typedef struct _GstBufferList GstBufferList;</pre>
+<p>
+Opaque list of grouped buffers.
+</p>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GstBufferListIterator"></a><h3>GstBufferListIterator</h3>
+<pre class="programlisting">typedef struct _GstBufferListIterator GstBufferListIterator;</pre>
+<p>
+Opaque iterator for a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>.
+</p>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GstBufferListDoFunction"></a><h3>GstBufferListDoFunction ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *         (*GstBufferListDoFunction)          (<em class="parameter"><code><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> *buffer</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
+<p>
+A function for accessing the last buffer returned by
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>. The function can leave <em class="parameter"><code>buffer</code></em> in the list,
+replace <em class="parameter"><code>buffer</code></em> in the list or remove <em class="parameter"><code>buffer</code></em> from the list, depending on
+the return value. If the function returns NULL, <em class="parameter"><code>buffer</code></em> will be removed from
+the list, otherwise <em class="parameter"><code>buffer</code></em> will be replaced with the returned buffer.
+</p>
+<p>
+The last buffer returned by <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> will be replaced
+with the buffer returned from the function. The function takes ownership of
+<em class="parameter"><code>buffer</code></em> and if a different value than <em class="parameter"><code>buffer</code></em> is returned, <em class="parameter"><code>buffer</code></em> must be
+unreffed. If NULL is returned, the buffer will be removed from the list. The
+list must be writable.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
+<td>the <a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the buffer to replace <em class="parameter"><code>buffer</code></em> in the list, or NULL
+to remove <em class="parameter"><code>buffer</code></em> from the list. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-new"></a><h3>gst_buffer_list_new ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="returnvalue">GstBufferList</span></a> *     gst_buffer_list_new                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Creates a new, empty <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>. The caller is responsible for unreffing
+the returned <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>.
+</p>
+<p>
+Free-function: gst_buffer_list_unref
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the new <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>. <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-unref" title="gst_buffer_list_unref ()"><code class="function">gst_buffer_list_unref()</code></a>
+after usage. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-ref"></a><h3>gst_buffer_list_ref ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="returnvalue">GstBufferList</span></a> *     gst_buffer_list_ref                 (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);</pre>
+<p>
+Increases the refcount of the given buffer list by one.
+</p>
+<p>
+Note that the refcount affects the writeability of <em class="parameter"><code>list</code></em> and its data, see
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-make-writable" title="gst_buffer_list_make_writable()"><code class="function">gst_buffer_list_make_writable()</code></a>. It is important to note that keeping
+additional references to GstBufferList instances can potentially increase
+the number of memcpy operations in a pipeline.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<em class="parameter"><code>list</code></em>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-unref"></a><h3>gst_buffer_list_unref ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gst_buffer_list_unref               (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);</pre>
+<p>
+Decreases the refcount of the buffer list. If the refcount reaches 0, the
+buffer list will be freed.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-copy"></a><h3>gst_buffer_list_copy ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="returnvalue">GstBufferList</span></a> *     gst_buffer_list_copy                (<em class="parameter"><code>const <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);</pre>
+<p>
+Create a shallow copy of the given buffer list. This will make a newly
+allocated copy of the source list with copies of buffer pointers. The
+refcount of buffers pointed to will be increased by one.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new copy of <em class="parameter"><code>list</code></em>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-is-writable"></a><h3>gst_buffer_list_is_writable()</h3>
+<pre class="programlisting">#define gst_buffer_list_is_writable(list) gst_mini_object_is_writable (GST_MINI_OBJECT_CAST (list))
+</pre>
+<p>
+Tests if you can safely add buffers and groups into a buffer list.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-make-writable"></a><h3>gst_buffer_list_make_writable()</h3>
+<pre class="programlisting">#define gst_buffer_list_make_writable(list) GST_BUFFER_LIST_CAST (gst_mini_object_make_writable (GST_MINI_OBJECT_CAST (list)))
+</pre>
+<p>
+Makes a writable buffer list from the given buffer list. If the source buffer
+list is already writable, this will simply return the same buffer list. A
+copy will otherwise be made using <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-copy" title="gst_buffer_list_copy ()"><code class="function">gst_buffer_list_copy()</code></a>.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a writable list, which may or may not be the
+same as <em class="parameter"><code>list</code></em>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-n-groups"></a><h3>gst_buffer_list_n_groups ()</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gst_buffer_list_n_groups            (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);</pre>
+<p>
+Returns the number of groups in <em class="parameter"><code>list</code></em>.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the number of groups in the buffer list</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GstBufferListItem"></a><h3>enum GstBufferListItem</h3>
+<pre class="programlisting">typedef enum {
+  GST_BUFFER_LIST_CONTINUE,
+  GST_BUFFER_LIST_SKIP_GROUP,
+  GST_BUFFER_LIST_END
+} GstBufferListItem;
+</pre>
+<p>
+The result of the <a class="link" href="gstreamer-GstBufferList.html#GstBufferListFunc" title="GstBufferListFunc ()"><span class="type">GstBufferListFunc</span></a>.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><a name="GST-BUFFER-LIST-CONTINUE:CAPS"></a><span class="term"><code class="literal">GST_BUFFER_LIST_CONTINUE</code></span></p></td>
+<td>Retrieve next buffer
+</td>
+</tr>
+<tr>
+<td><p><a name="GST-BUFFER-LIST-SKIP-GROUP:CAPS"></a><span class="term"><code class="literal">GST_BUFFER_LIST_SKIP_GROUP</code></span></p></td>
+<td>Skip to next group
+</td>
+</tr>
+<tr>
+<td><p><a name="GST-BUFFER-LIST-END:CAPS"></a><span class="term"><code class="literal">GST_BUFFER_LIST_END</code></span></p></td>
+<td>End iteration
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GstBufferListFunc"></a><h3>GstBufferListFunc ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBufferList.html#GstBufferListItem" title="enum GstBufferListItem"><span class="returnvalue">GstBufferListItem</span></a>   (*GstBufferListFunc)                (<em class="parameter"><code><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> **buffer</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> group</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> idx</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
+<p>
+A function that will be called from <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-foreach" title="gst_buffer_list_foreach ()"><code class="function">gst_buffer_list_foreach()</code></a>. The <em class="parameter"><code>buffer</code></em>
+field will point to a the reference of the buffer at <em class="parameter"><code>idx</code></em> in <em class="parameter"><code>group</code></em>.
+</p>
+<p>
+When this function returns <a class="link" href="gstreamer-GstBufferList.html#GST-BUFFER-LIST-CONTINUE:CAPS"><span class="type">GST_BUFFER_LIST_CONTINUE</span></a>, the next buffer will be
+returned. When <a class="link" href="gstreamer-GstBufferList.html#GST-BUFFER-LIST-SKIP-GROUP:CAPS"><span class="type">GST_BUFFER_LIST_SKIP_GROUP</span></a> is returned, all remaining buffers
+in the current group will be skipped and the first buffer of the next group
+is returned (if any). When GST_BUFFER_LIST_END is returned,
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-foreach" title="gst_buffer_list_foreach ()"><code class="function">gst_buffer_list_foreach()</code></a> will return.
+</p>
+<p>
+When <em class="parameter"><code>buffer</code></em> is set to NULL, the item will be removed from the bufferlist.
+When <em class="parameter"><code>buffer</code></em> has been made writable, the new buffer reference can be assigned
+to <em class="parameter"><code>buffer</code></em>. This function is responsible for unreffing the old buffer when
+removing or modifying.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
+<td>pointer the buffer</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
+<td>the group index of <em class="parameter"><code>buffer</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
+<td>the index in <em class="parameter"><code>group</code></em> of <em class="parameter"><code>buffer</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data passed to <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-foreach" title="gst_buffer_list_foreach ()"><code class="function">gst_buffer_list_foreach()</code></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListItem" title="enum GstBufferListItem"><span class="type">GstBufferListItem</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-foreach"></a><h3>gst_buffer_list_foreach ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gst_buffer_list_foreach             (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListFunc" title="GstBufferListFunc ()"><span class="type">GstBufferListFunc</span></a> func</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
+<p>
+Call <em class="parameter"><code>func</code></em> with <em class="parameter"><code>data</code></em> for each buffer in <em class="parameter"><code>list</code></em>.
+</p>
+<p>
+<em class="parameter"><code>func</code></em> can modify the passed buffer pointer or its contents. The return value
+of <em class="parameter"><code>func</code></em> define if this function returns or if the remaining buffers in a
+group should be skipped.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListFunc" title="GstBufferListFunc ()"><span class="type">GstBufferListFunc</span></a> to call. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data passed to <em class="parameter"><code>func</code></em>. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-get"></a><h3>gst_buffer_list_get ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               gst_buffer_list_get           (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> group</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> idx</code></em>);</pre>
+<p>
+Get the buffer at <em class="parameter"><code>idx</code></em> in <em class="parameter"><code>group</code></em>.
+</p>
+<p>
+Note that this function is not efficient for iterating over the entire list.
+Use an iterator or <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-foreach" title="gst_buffer_list_foreach ()"><code class="function">gst_buffer_list_foreach()</code></a> instead.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>group</code></em> :</span></p></td>
+<td>the group</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
+<td>the index in <em class="parameter"><code>group</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the buffer at <em class="parameter"><code>idx</code></em> in <em class="parameter"><code>group</code></em> or NULL when there
+is no buffer. The buffer remains valid as long as <em class="parameter"><code>list</code></em> is valid. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterate"></a><h3>gst_buffer_list_iterate ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="returnvalue">GstBufferListIterator</span></a> *   gst_buffer_list_iterate       (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> *list</code></em>);</pre>
+<p>
+Iterate the buffers in <em class="parameter"><code>list</code></em>. The owner of the iterator must also be the
+owner of a reference to <em class="parameter"><code>list</code></em> while the returned iterator is in use.
+</p>
+<p>
+Free-function: gst_buffer_list_iterator_free
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> of the buffers in
+<em class="parameter"><code>list</code></em>. <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-free" title="gst_buffer_list_iterator_free ()"><code class="function">gst_buffer_list_iterator_free()</code></a> after usage. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-free"></a><h3>gst_buffer_list_iterator_free ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gst_buffer_list_iterator_free       (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);</pre>
+<p>
+Free the iterator.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>the <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> to free. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-n-buffers"></a><h3>gst_buffer_list_iterator_n_buffers ()</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gst_buffer_list_iterator_n_buffers  (<em class="parameter"><code>const <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);</pre>
+<p>
+Returns the number of buffers left to iterate in the current group. I.e. the
+number of calls that can be made to <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> before
+it returns NULL.
+</p>
+<p>
+This function will not move the implicit cursor or in any other way affect
+the state of the iterator <em class="parameter"><code>it</code></em>.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the number of buffers left to iterate in the current group</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-add"></a><h3>gst_buffer_list_iterator_add ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gst_buffer_list_iterator_add        (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> *buffer</code></em>);</pre>
+<p>
+Inserts <em class="parameter"><code>buffer</code></em> into the <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> iterated with <em class="parameter"><code>it</code></em>. The buffer is
+inserted into the current group, immediately before the buffer that would be
+returned by <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>. The buffer is inserted before
+the implicit cursor, a subsequent call to <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>
+will return the buffer after the inserted buffer, if any.
+</p>
+<p>
+This function takes ownership of <em class="parameter"><code>buffer</code></em>.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-add-group"></a><h3>gst_buffer_list_iterator_add_group ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gst_buffer_list_iterator_add_group  (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);</pre>
+<p>
+Inserts a new, empty group into the <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> iterated with <em class="parameter"><code>it</code></em>. The
+group is inserted immediately before the group that would be returned by
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next-group" title="gst_buffer_list_iterator_next_group ()"><code class="function">gst_buffer_list_iterator_next_group()</code></a>. A subsequent call to
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next-group" title="gst_buffer_list_iterator_next_group ()"><code class="function">gst_buffer_list_iterator_next_group()</code></a> will advance the iterator to the group
+after the inserted group, if any.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-add-list"></a><h3>gst_buffer_list_iterator_add_list ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gst_buffer_list_iterator_add_list   (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *list</code></em>);</pre>
+<p>
+Inserts <em class="parameter"><code>list</code></em> of buffers into the <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> iterated with <em class="parameter"><code>it</code></em>. The list is
+inserted into the current group, immediately before the buffer that would be
+returned by <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>. The list is inserted before
+the implicit cursor, a subsequent call to <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>
+will return the buffer after the last buffer of the inserted list, if any.
+</p>
+<p>
+This function takes ownership of <em class="parameter"><code>list</code></em> and all its buffers.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
+<td>a <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of buffers. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gst.Buffer]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.31</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-next"></a><h3>gst_buffer_list_iterator_next ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               gst_buffer_list_iterator_next (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);</pre>
+<p>
+Returns the next buffer in the list iterated with <em class="parameter"><code>it</code></em>. If the iterator is at
+the end of a group, NULL will be returned. This function may be called
+repeatedly to iterate through the current group.
+</p>
+<p>
+The caller will not get a new ref to the returned <a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> and must not
+unref it.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the next buffer in the current group of the
+buffer list, or NULL. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-next-group"></a><h3>gst_buffer_list_iterator_next_group ()</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_buffer_list_iterator_next_group (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);</pre>
+<p>
+Advance the iterator <em class="parameter"><code>it</code></em> to the first buffer in the next group. If the
+iterator is at the last group, FALSE will be returned. This function may be
+called repeatedly to iterate through the groups in a buffer list.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>TRUE if the iterator could be advanced to the next group, FALSE if
+the iterator was already at the last group</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-remove"></a><h3>gst_buffer_list_iterator_remove ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gst_buffer_list_iterator_remove     (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);</pre>
+<p>
+Removes the last buffer returned by <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> from
+the <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> iterated with <em class="parameter"><code>it</code></em>. <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> must
+have been called on <em class="parameter"><code>it</code></em> before this function is called. This function can
+only be called once per call to <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>.
+</p>
+<p>
+The removed buffer is unreffed.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-steal"></a><h3>gst_buffer_list_iterator_steal ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               gst_buffer_list_iterator_steal
+                                                        (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);</pre>
+<p>
+Returns the last buffer returned by <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> without
+modifying the refcount of the buffer.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the last buffer returned by
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-take"></a><h3>gst_buffer_list_iterator_take ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gst_buffer_list_iterator_take       (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> *buffer</code></em>);</pre>
+<p>
+Replaces the last buffer returned by <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> with
+<em class="parameter"><code>buffer</code></em> in the <a class="link" href="gstreamer-GstBufferList.html#GstBufferList" title="GstBufferList"><span class="type">GstBufferList</span></a> iterated with <em class="parameter"><code>it</code></em> and takes ownership of
+<em class="parameter"><code>buffer</code></em>. <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> must have been called on <em class="parameter"><code>it</code></em> before
+this function is called. <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-remove" title="gst_buffer_list_iterator_remove ()"><code class="function">gst_buffer_list_iterator_remove()</code></a> must not have been
+called since the last call to <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>.
+</p>
+<p>
+This function unrefs the replaced buffer if it has not been stolen with
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-steal" title="gst_buffer_list_iterator_steal ()"><code class="function">gst_buffer_list_iterator_steal()</code></a> and takes ownership of <em class="parameter"><code>buffer</code></em> (i.e. the
+refcount of <em class="parameter"><code>buffer</code></em> is not increased).
+</p>
+<p>
+FIXME 0.11: this conditional taking-ownership is not good for bindings
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-do"></a><h3>gst_buffer_list_iterator_do ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               gst_buffer_list_iterator_do   (<em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gstreamer-GstBufferList.html#GstBufferListDoFunction" title="GstBufferListDoFunction ()"><span class="type">GstBufferListDoFunction</span></a> do_func</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
+<p>
+Calls the given function for the last buffer returned by
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>. <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a> must have
+been called on <em class="parameter"><code>it</code></em> before this function is called.
+<a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-remove" title="gst_buffer_list_iterator_remove ()"><code class="function">gst_buffer_list_iterator_remove()</code></a> and <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-steal" title="gst_buffer_list_iterator_steal ()"><code class="function">gst_buffer_list_iterator_steal()</code></a> must
+not have been called since the last call to <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>.
+</p>
+<p>
+See <a class="link" href="gstreamer-GstBufferList.html#GstBufferListDoFunction" title="GstBufferListDoFunction ()"><span class="type">GstBufferListDoFunction</span></a> for more details.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>do_func</code></em> :</span></p></td>
+<td>the function to be called. <span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>the gpointer to optional user data. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the return value from <em class="parameter"><code>do_func</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gst-buffer-list-iterator-merge-group"></a><h3>gst_buffer_list_iterator_merge_group ()</h3>
+<pre class="programlisting"><a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="returnvalue">GstBuffer</span></a> *               gst_buffer_list_iterator_merge_group
+                                                        (<em class="parameter"><code>const <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a> *it</code></em>);</pre>
+<p>
+Merge a buffer list group into a normal <a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a> by copying its metadata
+and memcpying its data into consecutive memory. All buffers in the current
+group after the implicit cursor will be merged into one new buffer. The
+metadata of the new buffer will be a copy of the metadata of the buffer that
+would be returned by <a class="link" href="gstreamer-GstBufferList.html#gst-buffer-list-iterator-next" title="gst_buffer_list_iterator_next ()"><code class="function">gst_buffer_list_iterator_next()</code></a>. If there is no buffer
+in the current group after the implicit cursor, NULL will be returned.
+</p>
+<p>
+This function will not move the implicit cursor or in any other way affect
+the state of the iterator <em class="parameter"><code>it</code></em> or the list.
+</p>
+<div class="variablelist"><table border="0">
+<col align="left" valign="top">
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>it</code></em> :</span></p></td>
+<td>a <a class="link" href="gstreamer-GstBufferList.html#GstBufferListIterator" title="GstBufferListIterator"><span class="type">GstBufferListIterator</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="gstreamer-GstBuffer.html#GstBuffer" title="struct GstBuffer"><span class="type">GstBuffer</span></a>, <a class="link" href="gstreamer-GstBuffer.html#gst-buffer-unref" title="gst_buffer_unref ()"><code class="function">gst_buffer_unref()</code></a> after usage,
+or NULL. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 0.10.24</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="gstreamer-GstBufferList.see-also"></a><h2>See Also</h2>
+<a class="link" href="GstPad.html" title="GstPad"><span class="type">GstPad</span></a>, <a class="link" href="gstreamer-GstMiniObject.html#GstMiniObject" title="struct GstMiniObject"><span class="type">GstMiniObject</span></a>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.17</div>
+</body>
+</html>