enable_sync_message_emission


Description:

public void enable_sync_message_emission ()

Instructs GStreamer to emit the "sync-message" signal after running the bus's sync handler.

This function is here so that code can ensure that they can synchronously receive messages without having to affect what the bin's sync handler is.

This function may be called multiple times. To clean up, the caller is responsible for calling disable_sync_message_emission as many times as this function is called.

While this function looks similar to gst_bus_add_signal_watch, it is not exactly the same -- this function enables *synchronous* emission of signals when messages arrive; gst_bus_add_signal_watch adds an idle callback to pop messages off the bus *asynchronously*. The sync-message signal comes from the thread of whatever object posted the message; the "message" signal is marshalled to the main thread via the MainLoop.

Parameters:

this

a Bus on which you want to receive the "sync-message" signal