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.