mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-12 03:16:33 +00:00
110 lines
1.9 KiB
Text
110 lines
1.9 KiB
Text
<!-- ##### SECTION Title ##### -->
|
|
GstBufferPool
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
Create buffers from a pool
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
A bufferpool is used to create buffers in an efficient way. En element
|
|
can maintain a bufferpool with a fixed number of buffers. This will reduce
|
|
the g_malloc and g_free overhead.
|
|
</para>
|
|
|
|
<para>
|
|
A bufferpool can also be used to implement direct access. A bufferpool can be
|
|
sent from one element to another so that the latter can directly write into
|
|
the memory of the element that maintains the bufferpool. This can greatly reduce
|
|
the number of memcpy operations.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GstBufferPool ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@new_buffer:
|
|
@new_user_data:
|
|
@destroy_user_data:
|
|
@destroy_buffer:
|
|
|
|
<!-- ##### USER_FUNCTION GstBufferPoolCreateFunction ##### -->
|
|
<para>
|
|
The function called when a buffer has to be created for this pool.
|
|
</para>
|
|
|
|
@pool: the pool from which to create the buffer
|
|
@user_data: any user data
|
|
@Returns: a new buffer from the pool
|
|
|
|
|
|
<!-- ##### USER_FUNCTION GstBufferPoolDestroyFunction ##### -->
|
|
<para>
|
|
This function will be called when the given buffer has to be returned to
|
|
the pool.
|
|
</para>
|
|
|
|
@pool: the pool to return the buffer to
|
|
@buffer: the buffer to return
|
|
@user_data: any user data
|
|
|
|
|
|
<!-- ##### FUNCTION gst_buffer_pool_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_buffer_pool_new_buffer ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pool:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_buffer_pool_destroy_buffer ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pool:
|
|
@buffer:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_buffer_pool_set_create_function ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pool:
|
|
@create:
|
|
@user_data:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_buffer_pool_set_destroy_function ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pool:
|
|
@destroy:
|
|
@user_data:
|
|
|
|
|
|
<!-- ##### FUNCTION gst_buffer_pool_destroy ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pool:
|
|
|
|
|