mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-10 11:29:55 +00:00
Code Issues 1 Projects Releases Wiki Activity

pipeline: clarify that applications should handle bus messages

Browse source 
The pipeline posts messages on the bus even if an application does not
handle the messages. This is expected behavior but may leak messages if
the messages are not handled.

Clarify the documentation.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/680>
This commit is contained in:
Michael Tretter 2020-10-23 17:44:10 +02:00 committed by GStreamer Merge Bot
parent cd978ffd6c
commit 77e6c98f6f
1 changed files with 6 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
gst/gstpipeline.c
View file

@ -40,8 +40,12 @@
* methods like gst_bin_add() and gst_bin_remove() (see #GstBin). * methods like gst_bin_add() and gst_bin_remove() (see #GstBin).
* *
* Before changing the state of the #GstPipeline (see #GstElement) a #GstBus * Before changing the state of the #GstPipeline (see #GstElement) a #GstBus
* can be retrieved with gst_pipeline_get_bus(). This bus can then be * should be retrieved with gst_pipeline_get_bus(). This #GstBus should then
* used to receive #GstMessage from the elements in the pipeline. * be used to receive #GstMessage from the elements in the pipeline. Listening
* to the #GstBus is necessary for retrieving error messages from the
* #GstPipeline and otherwise the #GstPipeline might stop without any
* indication, why. Furthermore, the #GstPipeline posts messages even if
* nobody listens on the #GstBus, which will pile up and use up memory.
* *
* By default, a #GstPipeline will automatically flush the pending #GstBus * By default, a #GstPipeline will automatically flush the pending #GstBus
* messages when going to the NULL state to ensure that no circular * messages when going to the NULL state to ensure that no circular