GstMessageType

The different message types that are available.

Values

ValueMeaning
UNKNOWN0

an undefined message

EOS1

end-of-stream reached in a pipeline. The application will only receive this message in the PLAYING state and every time it sets a pipeline to PLAYING that is in the EOS state. The application can perform a flushing seek in the pipeline, which will undo the EOS state again.

ERROR2

an error occurred. When the application receives an error message it should stop playback of the pipeline and not assume that more data will be played.

WARNING4

a warning occurred.

INFO8

an info message occurred

TAG16

a tag was found.

BUFFERING32

the pipeline is buffering. When the application receives a buffering message in the PLAYING state for a non-live pipeline it must PAUSE the pipeline until the buffering completes, when the percentage field in the message is 100%. For live pipelines, no action must be performed and the buffering percentage can be used to inform the user about the progress.

STATE_CHANGED64

a state change happened

STATE_DIRTY128

an element changed state in a streaming thread. This message is deprecated.

STEP_DONE256

a stepping operation finished.

CLOCK_PROVIDE512

an element notifies its capability of providing a clock. This message is used internally and never forwarded to the application.

CLOCK_LOST1024

The current clock as selected by the pipeline became unusable. The pipeline will select a new clock on the next PLAYING state change. The application should set the pipeline to PAUSED and back to PLAYING when this message is received.

NEW_CLOCK2048

a new clock was selected in the pipeline.

STRUCTURE_CHANGE4096

the structure of the pipeline changed. This message is used internally and never forwarded to the application.

STREAM_STATUS8192

status about a stream, emitted when it starts, stops, errors, etc..

APPLICATION16384

message posted by the application, possibly via an application-specific element.

ELEMENT32768

element-specific message, see the specific element's documentation

SEGMENT_START65536

pipeline started playback of a segment. This message is used internally and never forwarded to the application.

SEGMENT_DONE131072

pipeline completed playback of a segment. This message is forwarded to the application after all elements that posted GST_MESSAGE_SEGMENT_START posted a GST_MESSAGE_SEGMENT_DONE message.

DURATION_CHANGED262144

The duration of a pipeline changed. The application can get the new duration with a duration query.

LATENCY524288

Posted by elements when their latency changes. The application should recalculate and distribute a new latency.

ASYNC_START1048576

Posted by elements when they start an ASYNC GstStateChange This message is not forwarded to the application but is used internally.

ASYNC_DONE2097152

Posted by elements when they complete an ASYNC GstStateChange The application will only receive this message from the toplevel pipeline.

REQUEST_STATE4194304

Posted by elements when they want the pipeline to change state. This message is a suggestion to the application which can decide to perform the state change on (part of) the pipeline.

STEP_START8388608

A stepping operation was started.

QOS16777216

A buffer was dropped or an element changed its processing strategy for Quality of Service reasons.

PROGRESS33554432

A progress message.

TOC67108864

A new table of contents (TOC) was found or previously found TOC was updated.

RESET_TIME134217728

Message to request resetting the pipeline's running time from the pipeline. This is an internal message which applications will likely never receive.

STREAM_START268435456

Message indicating start of a new stream. Useful e.g. when using playbin in gapless playback mode, to get notified when the next title actually starts playing (which will be some time after the URI for the next title has been set).

NEED_CONTEXT536870912

Message indicating that an element wants a specific context (Since 1.2)

HAVE_CONTEXT1073741824

Message indicating that an element created a context (Since 1.2)

EXTENDED2147483648

Message is an extended message type (see below). These extended message IDs can't be used directly with mask-based API like Bus.poll or Bus.timedPopFiltered, but you can still filter for GST_MESSAGE_EXTENDED and then check the result for the specific type. (Since 1.4)

DEVICE_ADDED2147483649

Message indicating a gstreamer.Device was added to a gstreamer.DeviceProvider (Since 1.4)

DEVICE_REMOVED2147483650

Message indicating a gstreamer.Device was removed from a gstreamer.DeviceProvider (Since 1.4)

PROPERTY_NOTIFY2147483651

Message indicating a GObject property has changed (Since 1.10)

STREAM_COLLECTION2147483652

Message indicating a new gstreamer.StreamCollection is available (Since 1.10)

STREAMS_SELECTED2147483653

Message indicating the active selection of gstreamer.Streams has changed (Since 1.10)

REDIRECT2147483654

Message indicating to request the application to try to play the given URL(s). Useful if for example a HTTP 302/303 response is received with a non-HTTP URL inside. (Since 1.10)

DEVICE_CHANGED2147483654

Message indicating a gstreamer.Device was changed a gstreamer.DeviceProvider (Since 1.16)

ANY4294967295

mask for all of the above messages.