|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
<html>
|
|
Packit |
f546b1 |
<head>
|
|
Packit |
f546b1 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
Packit |
f546b1 |
<title>GstBus: GStreamer 1.0 Core Reference Manual</title>
|
|
Packit |
f546b1 |
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
|
|
Packit |
f546b1 |
<link rel="home" href="index.html" title="GStreamer 1.0 Core Reference Manual">
|
|
Packit |
f546b1 |
<link rel="up" href="libgstreamer.html" title="GStreamer Core Library">
|
|
Packit |
f546b1 |
<link rel="prev" href="GstBufferPool.html" title="GstBufferPool">
|
|
Packit |
f546b1 |
<link rel="next" href="GstCaps.html" title="GstCaps">
|
|
Packit |
f546b1 |
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
|
|
Packit |
f546b1 |
<link rel="stylesheet" href="style.css" type="text/css">
|
|
Packit |
f546b1 |
</head>
|
|
Packit |
f546b1 |
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Top |
|
|
Packit |
f546b1 |
Description |
|
|
Packit |
f546b1 |
Object Hierarchy |
|
|
Packit |
f546b1 |
Properties |
|
|
Packit |
f546b1 |
Signals
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstBus
|
|
Packit |
f546b1 |
GstBus — Asynchronous message bus subsystem
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Functions
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
(*GstBusFunc) ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstBusSyncReply
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
(*GstBusSyncHandler) ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstBus *
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_new ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_post ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_have_pending ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_peek ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_pop ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_pop_filtered ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_timed_pop ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_timed_pop_filtered ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_set_flushing ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_set_sync_handler ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstBusSyncReply
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_sync_signal_handler ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_get_pollfd ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GSource *
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_create_watch ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
guint
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_add_watch_full ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
guint
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_add_watch ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_remove_watch ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_disable_sync_message_emission ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_enable_sync_message_emission ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_async_signal_func ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_add_signal_watch ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_add_signal_watch_full ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_remove_signal_watch ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_poll ()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Properties
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
enable-async
|
|
Packit |
f546b1 |
Write / Construct Only
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Signals
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
message
|
|
Packit |
f546b1 |
Has Details
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
sync-message
|
|
Packit |
f546b1 |
Has Details
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Types and Values
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
struct
|
|
Packit |
f546b1 |
GstBus
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
enum
|
|
Packit |
f546b1 |
GstBusFlags
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
enum
|
|
Packit |
f546b1 |
GstBusSyncReply
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Object Hierarchy
|
|
Packit |
f546b1 |
GObject
|
|
Packit |
f546b1 |
╰── GInitiallyUnowned
|
|
Packit |
f546b1 |
╰── GstObject
|
|
Packit |
f546b1 |
╰── GstBus
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Includes
|
|
Packit |
f546b1 |
#include <gst/gst.h>
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Description
|
|
Packit |
f546b1 |
The GstBus is an object responsible for delivering GstMessage packets in
|
|
Packit |
f546b1 |
a first-in first-out way from the streaming threads (see GstTask) to the
|
|
Packit |
f546b1 |
application.
|
|
Packit |
f546b1 |
Since the application typically only wants to deal with delivery of these
|
|
Packit |
f546b1 |
messages from one thread, the GstBus will marshall the messages between
|
|
Packit |
f546b1 |
different threads. This is important since the actual streaming of media
|
|
Packit |
f546b1 |
is done in another thread than the application.
|
|
Packit |
f546b1 |
The GstBus provides support for GSource based notifications. This makes it
|
|
Packit |
f546b1 |
possible to handle the delivery in the glib mainloop.
|
|
Packit |
f546b1 |
The GSource callback function gst_bus_async_signal_func() can be used to
|
|
Packit |
f546b1 |
convert all bus messages into signal emissions.
|
|
Packit |
f546b1 |
A message is posted on the bus with the gst_bus_post() method. With the
|
|
Packit |
f546b1 |
gst_bus_peek() and gst_bus_pop() methods one can look at or retrieve a
|
|
Packit |
f546b1 |
previously posted message.
|
|
Packit |
f546b1 |
The bus can be polled with the gst_bus_poll() method. This methods blocks
|
|
Packit |
f546b1 |
up to the specified timeout value until one of the specified messages types
|
|
Packit |
f546b1 |
is posted on the bus. The application can then gst_bus_pop() the messages
|
|
Packit |
f546b1 |
from the bus to handle them.
|
|
Packit |
f546b1 |
Alternatively the application can register an asynchronous bus function
|
|
Packit |
f546b1 |
using gst_bus_add_watch_full() or gst_bus_add_watch(). This function will
|
|
Packit |
f546b1 |
install a GSource in the default glib main loop and will deliver messages
|
|
Packit |
f546b1 |
a short while after they have been posted. Note that the main loop should
|
|
Packit |
f546b1 |
be running for the asynchronous callbacks.
|
|
Packit |
f546b1 |
It is also possible to get messages from the bus without any thread
|
|
Packit |
f546b1 |
marshalling with the gst_bus_set_sync_handler() method. This makes it
|
|
Packit |
f546b1 |
possible to react to a message in the same thread that posted the
|
|
Packit |
f546b1 |
message on the bus. This should only be used if the application is able
|
|
Packit |
f546b1 |
to deal with messages from different threads.
|
|
Packit |
f546b1 |
Every GstPipeline has one bus.
|
|
Packit |
f546b1 |
Note that a GstPipeline will set its bus into flushing state when changing
|
|
Packit |
f546b1 |
from READY to NULL state.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Functions
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstBusFunc ()
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
(*GstBusFunc) (GstBus *bus,
|
|
Packit |
f546b1 |
GstMessage *message,
|
|
Packit |
f546b1 |
gpointer user_data);
|
|
Packit |
f546b1 |
Specifies the type of function passed to gst_bus_add_watch() or
|
|
Packit |
f546b1 |
gst_bus_add_watch_full(), which is called from the mainloop when a message
|
|
Packit |
f546b1 |
is available on the bus.
|
|
Packit |
f546b1 |
The message passed to the function will be unreffed after execution of this
|
|
Packit |
f546b1 |
function so it should not be freed in the function.
|
|
Packit |
f546b1 |
Note that this function is used as a GSourceFunc which means that returning
|
|
Packit |
f546b1 |
FALSE will remove the GSource from the mainloop.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
the GstBus that sent the message
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
message
|
|
Packit |
f546b1 |
the GstMessage
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
user_data
|
|
Packit |
f546b1 |
user data that has been given, when registering the handler
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
FALSE if the event source should be removed.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GstBusSyncHandler ()
|
|
Packit |
f546b1 |
GstBusSyncReply
|
|
Packit |
f546b1 |
(*GstBusSyncHandler) (GstBus *bus,
|
|
Packit |
f546b1 |
GstMessage *message,
|
|
Packit |
f546b1 |
gpointer user_data);
|
|
Packit |
f546b1 |
Handler will be invoked synchronously, when a new message has been injected
|
|
Packit |
f546b1 |
into the bus. This function is mostly used internally. Only one sync handler
|
|
Packit |
f546b1 |
can be attached to a given bus.
|
|
Packit |
f546b1 |
If the handler returns GST_BUS_DROP, it should unref the message, else the
|
|
Packit |
f546b1 |
message should not be unreffed by the sync handler.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
the GstBus that sent the message
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
message
|
|
Packit |
f546b1 |
the GstMessage
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
user_data
|
|
Packit |
f546b1 |
user data that has been given, when registering the handler
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
GstBusSyncReply stating what to do with the message
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_new ()
|
|
Packit |
f546b1 |
GstBus *
|
|
Packit |
f546b1 |
gst_bus_new (void);
|
|
Packit |
f546b1 |
Creates a new GstBus instance.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
a new GstBus instance.
|
|
Packit |
f546b1 |
[transfer full]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_post ()
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
gst_bus_post (GstBus *bus,
|
|
Packit |
f546b1 |
GstMessage *message);
|
|
Packit |
f546b1 |
Post a message on the given bus. Ownership of the message
|
|
Packit |
f546b1 |
is taken by the bus.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to post on
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
message
|
|
Packit |
f546b1 |
the GstMessage to post.
|
|
Packit |
f546b1 |
[transfer full]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
TRUE if the message could be posted, FALSE if the bus is flushing.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_have_pending ()
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
gst_bus_have_pending (GstBus *bus);
|
|
Packit |
f546b1 |
Check if there are pending messages on the bus that
|
|
Packit |
f546b1 |
should be handled.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to check
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
TRUE if there are messages on the bus to be handled, FALSE
|
|
Packit |
f546b1 |
otherwise.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_peek ()
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
gst_bus_peek (GstBus *bus);
|
|
Packit |
f546b1 |
Peek the message on the top of the bus' queue. The message will remain
|
|
Packit |
f546b1 |
on the bus' message queue. A reference is returned, and needs to be unreffed
|
|
Packit |
f546b1 |
by the caller.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
the GstMessage that is on the
|
|
Packit |
f546b1 |
bus, or NULL if the bus is empty.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
[transfer full][nullable]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_pop ()
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
gst_bus_pop (GstBus *bus);
|
|
Packit |
f546b1 |
Get a message from the bus.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to pop
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
the GstMessage that is on the
|
|
Packit |
f546b1 |
bus, or NULL if the bus is empty. The message is taken from
|
|
Packit |
f546b1 |
the bus and needs to be unreffed with gst_message_unref() after
|
|
Packit |
f546b1 |
usage.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
[transfer full][nullable]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_pop_filtered ()
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
gst_bus_pop_filtered (GstBus *bus,
|
|
Packit |
f546b1 |
GstMessageType types);
|
|
Packit |
f546b1 |
Get a message matching type
|
|
Packit |
f546b1 |
from the bus. Will discard all messages on
|
|
Packit |
f546b1 |
the bus that do not match type
|
|
Packit |
f546b1 |
and that have been posted before the first
|
|
Packit |
f546b1 |
message that does match type
|
|
Packit |
f546b1 |
. If there is no message matching type
|
|
Packit |
f546b1 |
on
|
|
Packit |
f546b1 |
the bus, all messages will be discarded. It is not possible to use message
|
|
Packit |
f546b1 |
enums beyond GST_MESSAGE_EXTENDED in the events
|
|
Packit |
f546b1 |
mask.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to pop
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
types
|
|
Packit |
f546b1 |
message types to take into account
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
the next GstMessage matching
|
|
Packit |
f546b1 |
type
|
|
Packit |
f546b1 |
that is on the bus, or NULL if the bus is empty or there
|
|
Packit |
f546b1 |
is no message matching type
|
|
Packit |
f546b1 |
. The message is taken from the bus
|
|
Packit |
f546b1 |
and needs to be unreffed with gst_message_unref() after usage.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
[transfer full][nullable]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_timed_pop ()
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
gst_bus_timed_pop (GstBus *bus,
|
|
Packit |
f546b1 |
GstClockTime timeout);
|
|
Packit |
f546b1 |
Get a message from the bus, waiting up to the specified timeout.
|
|
Packit |
f546b1 |
If timeout
|
|
Packit |
f546b1 |
is 0, this function behaves like gst_bus_pop(). If timeout
|
|
Packit |
f546b1 |
is
|
|
Packit |
f546b1 |
GST_CLOCK_TIME_NONE, this function will block forever until a message was
|
|
Packit |
f546b1 |
posted on the bus.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to pop
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
timeout
|
|
Packit |
f546b1 |
a timeout
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
the GstMessage that is on the
|
|
Packit |
f546b1 |
bus after the specified timeout or NULL if the bus is empty
|
|
Packit |
f546b1 |
after the timeout expired. The message is taken from the bus
|
|
Packit |
f546b1 |
and needs to be unreffed with gst_message_unref() after usage.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
[transfer full][nullable]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_timed_pop_filtered ()
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
gst_bus_timed_pop_filtered (GstBus *bus,
|
|
Packit |
f546b1 |
GstClockTime timeout,
|
|
Packit |
f546b1 |
GstMessageType types);
|
|
Packit |
f546b1 |
Get a message from the bus whose type matches the message type mask types
|
|
Packit |
f546b1 |
,
|
|
Packit |
f546b1 |
waiting up to the specified timeout (and discarding any messages that do not
|
|
Packit |
f546b1 |
match the mask provided).
|
|
Packit |
f546b1 |
If timeout
|
|
Packit |
f546b1 |
is 0, this function behaves like gst_bus_pop_filtered(). If
|
|
Packit |
f546b1 |
timeout
|
|
Packit |
f546b1 |
is GST_CLOCK_TIME_NONE, this function will block forever until a
|
|
Packit |
f546b1 |
matching message was posted on the bus.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to pop from
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
timeout
|
|
Packit |
f546b1 |
a timeout in nanoseconds, or GST_CLOCK_TIME_NONE to wait forever
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
types
|
|
Packit |
f546b1 |
message types to take into account, GST_MESSAGE_ANY for any type
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
a GstMessage matching the
|
|
Packit |
f546b1 |
filter in types
|
|
Packit |
f546b1 |
, or NULL if no matching message was found on
|
|
Packit |
f546b1 |
the bus until the timeout expired. The message is taken from
|
|
Packit |
f546b1 |
the bus and needs to be unreffed with gst_message_unref() after
|
|
Packit |
f546b1 |
usage.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
[transfer full][nullable]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_set_flushing ()
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
gst_bus_set_flushing (GstBus *bus,
|
|
Packit |
f546b1 |
gboolean flushing);
|
|
Packit |
f546b1 |
If flushing
|
|
Packit |
f546b1 |
, flush out and unref any messages queued in the bus. Releases
|
|
Packit |
f546b1 |
references to the message origin objects. Will flush future messages until
|
|
Packit |
f546b1 |
gst_bus_set_flushing() sets flushing
|
|
Packit |
f546b1 |
to FALSE.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
flushing
|
|
Packit |
f546b1 |
whether or not to flush the bus
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_set_sync_handler ()
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
gst_bus_set_sync_handler (GstBus *bus,
|
|
Packit |
f546b1 |
GstBusSyncHandler func,
|
|
Packit |
f546b1 |
gpointer user_data,
|
|
Packit |
f546b1 |
GDestroyNotify notify);
|
|
Packit |
f546b1 |
Sets the synchronous handler on the bus. The function will be called
|
|
Packit |
f546b1 |
every time a new message is posted on the bus. Note that the function
|
|
Packit |
f546b1 |
will be called in the same thread context as the posting object. This
|
|
Packit |
f546b1 |
function is usually only called by the creator of the bus. Applications
|
|
Packit |
f546b1 |
should handle messages asynchronously using the gst_bus watch and poll
|
|
Packit |
f546b1 |
functions.
|
|
Packit |
f546b1 |
You cannot replace an existing sync_handler. You can pass NULL to this
|
|
Packit |
f546b1 |
function, which will clear the existing handler.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to install the handler on
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
func
|
|
Packit |
f546b1 |
The handler function to install.
|
|
Packit |
f546b1 |
[allow-none]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
user_data
|
|
Packit |
f546b1 |
User data that will be sent to the handler function.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
notify
|
|
Packit |
f546b1 |
called when user_data
|
|
Packit |
f546b1 |
becomes unused
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_sync_signal_handler ()
|
|
Packit |
f546b1 |
GstBusSyncReply
|
|
Packit |
f546b1 |
gst_bus_sync_signal_handler (GstBus *bus,
|
|
Packit |
f546b1 |
GstMessage *message,
|
|
Packit |
f546b1 |
gpointer data);
|
|
Packit |
f546b1 |
A helper GstBusSyncHandler that can be used to convert all synchronous
|
|
Packit |
f546b1 |
messages into signals.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
message
|
|
Packit |
f546b1 |
the GstMessage received
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
data
|
|
Packit |
f546b1 |
user data
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
GST_BUS_PASS
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_get_pollfd ()
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
gst_bus_get_pollfd (GstBus *bus,
|
|
Packit |
f546b1 |
GPollFD *fd);
|
|
Packit |
f546b1 |
Gets the file descriptor from the bus which can be used to get notified about
|
|
Packit |
f546b1 |
messages being available with functions like g_poll(), and allows integration
|
|
Packit |
f546b1 |
into other event loops based on file descriptors.
|
|
Packit |
f546b1 |
Whenever a message is available, the POLLIN / G_IO_IN event is set.
|
|
Packit |
f546b1 |
Warning: NEVER read or write anything to the returned fd but only use it
|
|
Packit |
f546b1 |
for getting notifications via g_poll() or similar and then use the normal
|
|
Packit |
f546b1 |
GstBus API, e.g. gst_bus_pop().
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
A GstBus
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
fd
|
|
Packit |
f546b1 |
A GPollFD to fill
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Since: 1.14
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_create_watch ()
|
|
Packit |
f546b1 |
GSource *
|
|
Packit |
f546b1 |
gst_bus_create_watch (GstBus *bus);
|
|
Packit |
f546b1 |
Create watch for this bus. The GSource will be dispatched whenever
|
|
Packit |
f546b1 |
a message is on the bus. After the GSource is dispatched, the
|
|
Packit |
f546b1 |
message is popped off the bus and unreffed.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to create the watch for
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
a GSource that can be added to a mainloop.
|
|
Packit |
f546b1 |
[transfer full][nullable]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_add_watch_full ()
|
|
Packit |
f546b1 |
guint
|
|
Packit |
f546b1 |
gst_bus_add_watch_full (GstBus *bus,
|
|
Packit |
f546b1 |
gint priority,
|
|
Packit |
f546b1 |
GstBusFunc func,
|
|
Packit |
f546b1 |
gpointer user_data,
|
|
Packit |
f546b1 |
GDestroyNotify notify);
|
|
Packit |
f546b1 |
Adds a bus watch to the default main context with the given priority
|
|
Packit |
f546b1 |
(e.g.
|
|
Packit |
f546b1 |
G_PRIORITY_DEFAULT). It is also possible to use a non-default main
|
|
Packit |
f546b1 |
context set up using g_main_context_push_thread_default() (before
|
|
Packit |
f546b1 |
one had to create a bus watch source and attach it to the desired main
|
|
Packit |
f546b1 |
context 'manually').
|
|
Packit |
f546b1 |
This function is used to receive asynchronous messages in the main loop.
|
|
Packit |
f546b1 |
There can only be a single bus watch per bus, you must remove it before you
|
|
Packit |
f546b1 |
can set a new one.
|
|
Packit |
f546b1 |
The bus watch will only work if a GLib main loop is being run.
|
|
Packit |
f546b1 |
When func
|
|
Packit |
f546b1 |
is called, the message belongs to the caller; if you want to
|
|
Packit |
f546b1 |
keep a copy of it, call gst_message_ref() before leaving func
|
|
Packit |
f546b1 |
.
|
|
Packit |
f546b1 |
The watch can be removed using gst_bus_remove_watch() or by returning FALSE
|
|
Packit |
f546b1 |
from func
|
|
Packit |
f546b1 |
. If the watch was added to the default main context it is also
|
|
Packit |
f546b1 |
possible to remove the watch using g_source_remove().
|
|
Packit |
f546b1 |
The bus watch will take its own reference to the bus
|
|
Packit |
f546b1 |
, so it is safe to unref
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
using gst_object_unref() after setting the bus watch.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
[rename-to gst_bus_add_watch]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to create the watch for.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
priority
|
|
Packit |
f546b1 |
The priority of the watch.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
func
|
|
Packit |
f546b1 |
A function to call when a message is received.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
user_data
|
|
Packit |
f546b1 |
user data passed to func
|
|
Packit |
f546b1 |
.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
notify
|
|
Packit |
f546b1 |
the function to call when the source is removed.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
The event source id or 0 if bus
|
|
Packit |
f546b1 |
already got an event source.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_add_watch ()
|
|
Packit |
f546b1 |
guint
|
|
Packit |
f546b1 |
gst_bus_add_watch (GstBus *bus,
|
|
Packit |
f546b1 |
GstBusFunc func,
|
|
Packit |
f546b1 |
gpointer user_data);
|
|
Packit |
f546b1 |
Adds a bus watch to the default main context with the default priority
|
|
Packit |
f546b1 |
(G_PRIORITY_DEFAULT). It is also possible to use a non-default main
|
|
Packit |
f546b1 |
context set up using g_main_context_push_thread_default() (before
|
|
Packit |
f546b1 |
one had to create a bus watch source and attach it to the desired main
|
|
Packit |
f546b1 |
context 'manually').
|
|
Packit |
f546b1 |
This function is used to receive asynchronous messages in the main loop.
|
|
Packit |
f546b1 |
There can only be a single bus watch per bus, you must remove it before you
|
|
Packit |
f546b1 |
can set a new one.
|
|
Packit |
f546b1 |
The bus watch will only work if a GLib main loop is being run.
|
|
Packit |
f546b1 |
The watch can be removed using gst_bus_remove_watch() or by returning FALSE
|
|
Packit |
f546b1 |
from func
|
|
Packit |
f546b1 |
. If the watch was added to the default main context it is also
|
|
Packit |
f546b1 |
possible to remove the watch using g_source_remove().
|
|
Packit |
f546b1 |
The bus watch will take its own reference to the bus
|
|
Packit |
f546b1 |
, so it is safe to unref
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
using gst_object_unref() after setting the bus watch.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
[skip]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to create the watch for
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
func
|
|
Packit |
f546b1 |
A function to call when a message is received.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
user_data
|
|
Packit |
f546b1 |
user data passed to func
|
|
Packit |
f546b1 |
.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
The event source id or 0 if bus
|
|
Packit |
f546b1 |
already got an event source.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_remove_watch ()
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
gst_bus_remove_watch (GstBus *bus);
|
|
Packit |
f546b1 |
Removes an installed bus watch from bus
|
|
Packit |
f546b1 |
.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus to remove the watch from.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
TRUE on success or FALSE if bus
|
|
Packit |
f546b1 |
has no event source.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Since: 1.6
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_disable_sync_message_emission ()
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
gst_bus_disable_sync_message_emission (GstBus *bus);
|
|
Packit |
f546b1 |
Instructs GStreamer to stop emitting the "sync-message" signal for this bus.
|
|
Packit |
f546b1 |
See gst_bus_enable_sync_message_emission() for more information.
|
|
Packit |
f546b1 |
In the event that multiple pieces of code have called
|
|
Packit |
f546b1 |
gst_bus_enable_sync_message_emission(), the sync-message emissions will only
|
|
Packit |
f546b1 |
be stopped after all calls to gst_bus_enable_sync_message_emission() were
|
|
Packit |
f546b1 |
"cancelled" by calling this function. In this way the semantics are exactly
|
|
Packit |
f546b1 |
the same as gst_object_ref() that which calls enable should also call
|
|
Packit |
f546b1 |
disable.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus on which you previously called
|
|
Packit |
f546b1 |
gst_bus_enable_sync_message_emission()
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_enable_sync_message_emission ()
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
gst_bus_enable_sync_message_emission (GstBus *bus);
|
|
Packit |
f546b1 |
Instructs GStreamer to emit the "sync-message" signal after running the bus's
|
|
Packit |
f546b1 |
sync handler. This function is here so that code can ensure that they can
|
|
Packit |
f546b1 |
synchronously receive messages without having to affect what the bin's sync
|
|
Packit |
f546b1 |
handler is.
|
|
Packit |
f546b1 |
This function may be called multiple times. To clean up, the caller is
|
|
Packit |
f546b1 |
responsible for calling gst_bus_disable_sync_message_emission() as many times
|
|
Packit |
f546b1 |
as this function is called.
|
|
Packit |
f546b1 |
While this function looks similar to gst_bus_add_signal_watch(), it is not
|
|
Packit |
f546b1 |
exactly the same -- this function enables synchronous emission of
|
|
Packit |
f546b1 |
signals when messages arrive; gst_bus_add_signal_watch() adds an idle callback
|
|
Packit |
f546b1 |
to pop messages off the bus asynchronously. The sync-message signal
|
|
Packit |
f546b1 |
comes from the thread of whatever object posted the message; the "message"
|
|
Packit |
f546b1 |
signal is marshalled to the main thread via the main loop.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus on which you want to receive the "sync-message" signal
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_async_signal_func ()
|
|
Packit |
f546b1 |
gboolean
|
|
Packit |
f546b1 |
gst_bus_async_signal_func (GstBus *bus,
|
|
Packit |
f546b1 |
GstMessage *message,
|
|
Packit |
f546b1 |
gpointer data);
|
|
Packit |
f546b1 |
A helper GstBusFunc that can be used to convert all asynchronous messages
|
|
Packit |
f546b1 |
into signals.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
message
|
|
Packit |
f546b1 |
the GstMessage received
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
data
|
|
Packit |
f546b1 |
user data
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
TRUE
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_add_signal_watch ()
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
gst_bus_add_signal_watch (GstBus *bus);
|
|
Packit |
f546b1 |
Adds a bus signal watch to the default main context with the default priority
|
|
Packit |
f546b1 |
(G_PRIORITY_DEFAULT). It is also possible to use a non-default
|
|
Packit |
f546b1 |
main context set up using g_main_context_push_thread_default() (before
|
|
Packit |
f546b1 |
one had to create a bus watch source and attach it to the desired main
|
|
Packit |
f546b1 |
context 'manually').
|
|
Packit |
f546b1 |
After calling this statement, the bus will emit the "message" signal for each
|
|
Packit |
f546b1 |
message posted on the bus.
|
|
Packit |
f546b1 |
This function may be called multiple times. To clean up, the caller is
|
|
Packit |
f546b1 |
responsible for calling gst_bus_remove_signal_watch() as many times as this
|
|
Packit |
f546b1 |
function is called.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus on which you want to receive the "message" signal
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_add_signal_watch_full ()
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
gst_bus_add_signal_watch_full (GstBus *bus,
|
|
Packit |
f546b1 |
gint priority);
|
|
Packit |
f546b1 |
Adds a bus signal watch to the default main context with the given priority
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
(e.g. G_PRIORITY_DEFAULT). It is also possible to use a non-default main
|
|
Packit |
f546b1 |
context set up using g_main_context_push_thread_default()
|
|
Packit |
f546b1 |
(before one had to create a bus watch source and attach it to the desired
|
|
Packit |
f546b1 |
main context 'manually').
|
|
Packit |
f546b1 |
After calling this statement, the bus will emit the "message" signal for each
|
|
Packit |
f546b1 |
message posted on the bus when the main loop is running.
|
|
Packit |
f546b1 |
This function may be called multiple times. To clean up, the caller is
|
|
Packit |
f546b1 |
responsible for calling gst_bus_remove_signal_watch() as many times as this
|
|
Packit |
f546b1 |
function is called.
|
|
Packit |
f546b1 |
There can only be a single bus watch per bus, you must remove any signal
|
|
Packit |
f546b1 |
watch before you can set another type of watch.
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus on which you want to receive the "message" signal
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
priority
|
|
Packit |
f546b1 |
The priority of the watch.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_remove_signal_watch ()
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
gst_bus_remove_signal_watch (GstBus *bus);
|
|
Packit |
f546b1 |
Removes a signal watch previously added with gst_bus_add_signal_watch().
|
|
Packit |
f546b1 |
MT safe.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus you previously added a signal watch to
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
gst_bus_poll ()
|
|
Packit |
f546b1 |
GstMessage *
|
|
Packit |
f546b1 |
gst_bus_poll (GstBus *bus,
|
|
Packit |
f546b1 |
GstMessageType events,
|
|
Packit |
f546b1 |
GstClockTime timeout);
|
|
Packit |
f546b1 |
Poll the bus for messages. Will block while waiting for messages to come.
|
|
Packit |
f546b1 |
You can specify a maximum time to poll with the timeout
|
|
Packit |
f546b1 |
parameter. If
|
|
Packit |
f546b1 |
timeout
|
|
Packit |
f546b1 |
is negative, this function will block indefinitely.
|
|
Packit |
f546b1 |
All messages not in events
|
|
Packit |
f546b1 |
will be popped off the bus and will be ignored.
|
|
Packit |
f546b1 |
It is not possible to use message enums beyond GST_MESSAGE_EXTENDED in the
|
|
Packit |
f546b1 |
events
|
|
Packit |
f546b1 |
mask
|
|
Packit |
f546b1 |
Because poll is implemented using the "message" signal enabled by
|
|
Packit |
f546b1 |
gst_bus_add_signal_watch(), calling gst_bus_poll() will cause the "message"
|
|
Packit |
f546b1 |
signal to be emitted for every message that poll sees. Thus a "message"
|
|
Packit |
f546b1 |
signal handler will see the same messages that this function sees -- neither
|
|
Packit |
f546b1 |
will steal messages from the other.
|
|
Packit |
f546b1 |
This function will run a main loop from the default main context when
|
|
Packit |
f546b1 |
polling.
|
|
Packit |
f546b1 |
You should never use this function, since it is pure evil. This is
|
|
Packit |
f546b1 |
especially true for GUI applications based on Gtk+ or Qt, but also for any
|
|
Packit |
f546b1 |
other non-trivial application that uses the GLib main loop. As this function
|
|
Packit |
f546b1 |
runs a GLib main loop, any callback attached to the default GLib main
|
|
Packit |
f546b1 |
context may be invoked. This could be timeouts, GUI events, I/O events etc.;
|
|
Packit |
f546b1 |
even if gst_bus_poll() is called with a 0 timeout. Any of these callbacks
|
|
Packit |
f546b1 |
may do things you do not expect, e.g. destroy the main application window or
|
|
Packit |
f546b1 |
some other resource; change other application state; display a dialog and
|
|
Packit |
f546b1 |
run another main loop until the user clicks it away. In short, using this
|
|
Packit |
f546b1 |
function may add a lot of complexity to your code through unexpected
|
|
Packit |
f546b1 |
re-entrancy and unexpected changes to your application's state.
|
|
Packit |
f546b1 |
For 0 timeouts use gst_bus_pop_filtered() instead of this function; for
|
|
Packit |
f546b1 |
other short timeouts use gst_bus_timed_pop_filtered(); everything else is
|
|
Packit |
f546b1 |
better handled by setting up an asynchronous bus watch and doing things
|
|
Packit |
f546b1 |
from there.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
a GstBus
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
events
|
|
Packit |
f546b1 |
a mask of GstMessageType, representing the set of message types to
|
|
Packit |
f546b1 |
poll for (note special handling of extended message types below)
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
timeout
|
|
Packit |
f546b1 |
the poll timeout, as a GstClockTime, or GST_CLOCK_TIME_NONE to poll
|
|
Packit |
f546b1 |
indefinitely.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Returns
|
|
Packit |
f546b1 |
the message that was received,
|
|
Packit |
f546b1 |
or NULL if the poll timed out. The message is taken from the
|
|
Packit |
f546b1 |
bus and needs to be unreffed with gst_message_unref() after
|
|
Packit |
f546b1 |
usage.
|
|
Packit |
f546b1 |
[transfer full][nullable]
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Types and Values
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
struct GstBus
|
|
Packit |
f546b1 |
struct GstBus;
|
|
Packit |
f546b1 |
The opaque GstBus data structure.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
enum GstBusFlags
|
|
Packit |
f546b1 |
The standard flags that a bus may have.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Members
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GST_BUS_FLUSHING
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
The bus is currently dropping all messages
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GST_BUS_FLAG_LAST
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
offset to define more flags
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
enum GstBusSyncReply
|
|
Packit |
f546b1 |
The result values for a GstBusSyncHandler.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Members
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GST_BUS_DROP
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
drop the message
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GST_BUS_PASS
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
pass the message to the async queue
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
GST_BUS_ASYNC
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
pass message to async queue, continue if message is handled
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Property Details
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
The “enable-async” property
|
|
Packit |
f546b1 |
“enable-async” gboolean
|
|
Packit |
f546b1 |
Enable async message delivery for bus watches and gst_bus_pop().
|
|
Packit |
f546b1 |
Flags: Write / Construct Only
|
|
Packit |
f546b1 |
Default value: TRUE
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Signal Details
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
The “message” signal
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
user_function (GstBus *bus,
|
|
Packit |
f546b1 |
GstMessage *message,
|
|
Packit |
f546b1 |
gpointer user_data)
|
|
Packit |
f546b1 |
A message has been posted on the bus. This signal is emitted from a
|
|
Packit |
f546b1 |
GSource added to the mainloop. this signal will only be emitted when
|
|
Packit |
f546b1 |
there is a mainloop running.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
the object which received the signal
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
message
|
|
Packit |
f546b1 |
the message that has been posted asynchronously
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
user_data
|
|
Packit |
f546b1 |
user data set when the signal handler was connected.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Flags: Has Details
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
The “sync-message” signal
|
|
Packit |
f546b1 |
void
|
|
Packit |
f546b1 |
user_function (GstBus *bus,
|
|
Packit |
f546b1 |
GstMessage *message,
|
|
Packit |
f546b1 |
gpointer user_data)
|
|
Packit |
f546b1 |
A message has been posted on the bus. This signal is emitted from the
|
|
Packit |
f546b1 |
thread that posted the message so one has to be careful with locking.
|
|
Packit |
f546b1 |
This signal will not be emitted by default, you have to call
|
|
Packit |
f546b1 |
gst_bus_enable_sync_message_emission() before.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Parameters
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
bus
|
|
Packit |
f546b1 |
the object which received the signal
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
message
|
|
Packit |
f546b1 |
the message that has been posted synchronously
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
user_data
|
|
Packit |
f546b1 |
user data set when the signal handler was connected.
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Flags: Has Details
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
See Also
|
|
Packit |
f546b1 |
GstMessage, GstElement
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
|
|
Packit |
f546b1 |
Generated by GTK-Doc V1.27
|
|
Packit |
f546b1 |
</body>
|
|
Packit |
f546b1 |
</html>
|