mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-09-29 15:22:17 +00:00
Code Issues 1 Projects Releases Wiki Activity

docs: Improve gst_buffer_get_meta() to clear up confusion

Browse source 
I was confused by the existence of `gst_buffer_get_meta` as it suggested
to me that you should only attach one of any type of GstMeta to a buffer.
It's perfectly fine to attach multiple from a single API so I'm
documenting that here.

https://bugzilla.gnome.org/show_bug.cgi?id=737129
This commit is contained in:
William Manley 2014-09-22 17:27:31 +01:00 committed by Sebastian Dröge
parent 4707c0410c
commit f6b053d375
1 changed files with 5 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
gst/gstbuffer.c
View file

@ -1935,8 +1935,11 @@ gst_buffer_append_region (GstBuffer * buf1, GstBuffer * buf2, gssize offset,
* @buffer: a #GstBuffer
* @api: the #GType of an API
*
* Get the metadata for @api on buffer. When there is no such
* metadata, %NULL is returned.
* Get the metadata for @api on buffer. When there is no such metadata, %NULL is
* returned. If multiple metadata with the given @api are attached to this
* buffer only the first one is returned. To handle multiple metadata with a
* given API use gst_buffer_iterate_meta() or gst_buffer_foreach_meta() instead
* and check the meta->info.api member for the API type.
*
* Returns: (transfer none) (nullable): the metadata for @api on
* @buffer.