parse_tag


Description:

public void parse_tag (out TagList tag_list)

Extracts the tag list from the GstMessage.

The tag list returned in the output argument is a copy; the caller must free it when done.

Typical usage of this function might be:

  ...
switch (GST_MESSAGE_TYPE (msg)) {
case GST_MESSAGE_TAG: {
GstTagList *tags = NULL;

gst_message_parse_tag (msg, &tags);
g_print ("Got tags from element %s\n", GST_OBJECT_NAME (msg->src));
handle_tags (tags);
gst_tag_list_unref (tags);
break;
}
...
}
...

MT safe.

Parameters:

this

A valid Message of type GST_MESSAGE_TAG.

tag_list

return location for the tag-list.