/**
* gst_message_parse_tag:
* @message: A valid #GstMessage of type GST_MESSAGE_TAG.
- * @tag_list: Return location for the tag-list.
+ * @tag_list: (out): Return location for the 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.
/**
* gst_message_parse_tag_full:
* @message: A valid #GstMessage of type GST_MESSAGE_TAG.
- * @pad: Location where the originating pad is stored, unref after usage
- * @tag_list: Return location for the tag-list.
+ * @pad: (out): Location where the originating pad is stored, unref after usage
+ * @tag_list: (out): Return location for the 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.
/**
* gst_message_parse_buffering:
* @message: A valid #GstMessage of type GST_MESSAGE_BUFFERING.
- * @percent: Return location for the percent.
+ * @percent: (out): Return location for the percent.
*
* Extracts the buffering percent from the GstMessage. see also
* gst_message_new_buffering().
/**
* gst_message_parse_buffering_stats:
* @message: A valid #GstMessage of type GST_MESSAGE_BUFFERING.
- * @mode: a buffering mode
- * @avg_in: the average input rate
- * @avg_out: the average output rate
- * @buffering_left: amount of buffering time left in milliseconds.
+ * @mode: (out): a buffering mode
+ * @avg_in: (out): the average input rate
+ * @avg_out: (out): the average output rate
+ * @buffering_left: (out): amount of buffering time left in milliseconds.
*
* Extracts the buffering stats values from @message.
*
/**
* gst_message_parse_state_changed:
* @message: a valid #GstMessage of type GST_MESSAGE_STATE_CHANGED
- * @oldstate: the previous state, or NULL
- * @newstate: the new (current) state, or NULL
- * @pending: the pending (target) state, or NULL
+ * @oldstate: (out): the previous state, or NULL
+ * @newstate: (out): the new (current) state, or NULL
+ * @pending: (out): the pending (target) state, or NULL
*
* Extracts the old and new states from the GstMessage.
*
/**
* gst_message_parse_clock_provide:
* @message: A valid #GstMessage of type GST_MESSAGE_CLOCK_PROVIDE.
- * @clock: A pointer to hold a clock object.
- * @ready: A pointer to hold the ready flag.
+ * @clock: (out): A pointer to hold a clock object.
+ * @ready: (out): A pointer to hold the ready flag.
*
* Extracts the clock and ready flag from the GstMessage.
* The clock object returned remains valid until the message is freed.
/**
* gst_message_parse_clock_lost:
* @message: A valid #GstMessage of type GST_MESSAGE_CLOCK_LOST.
- * @clock: A pointer to hold the lost clock
+ * @clock: (out): A pointer to hold the lost clock
*
* Extracts the lost clock from the GstMessage.
* The clock object returned remains valid until the message is freed.
/**
* gst_message_parse_structure_change:
* @message: A valid #GstMessage of type GST_MESSAGE_STRUCTURE_CHANGE.
- * @type: A pointer to hold the change type
- * @owner: The owner element of the message source
- * @busy: A pointer to hold whether the change is in progress or has been
+ * @type: (out): A pointer to hold the change type
+ * @owner: (out): The owner element of the message source
+ * @busy: (out): A pointer to hold whether the change is in progress or has been
* completed
*
* Extracts the change type and completion status from the GstMessage.
/**
* gst_message_parse_error:
* @message: A valid #GstMessage of type GST_MESSAGE_ERROR.
- * @gerror: Location for the GError
- * @debug: Location for the debug message, or NULL
+ * @gerror: (out): Location for the GError
+ * @debug: (out): Location for the debug message, or NULL
*
* Extracts the GError and debug string from the GstMessage. The values returned
* in the output arguments are copies; the caller must free them when done.
/**
* gst_message_parse_warning:
* @message: A valid #GstMessage of type GST_MESSAGE_WARNING.
- * @gerror: Location for the GError
- * @debug: Location for the debug message, or NULL
+ * @gerror: (out): Location for the GError
+ * @debug: (out): Location for the debug message, or NULL
*
* Extracts the GError and debug string from the GstMessage. The values returned
* in the output arguments are copies; the caller must free them when done.
/**
* gst_message_parse_info:
* @message: A valid #GstMessage of type GST_MESSAGE_INFO.
- * @gerror: Location for the GError
- * @debug: Location for the debug message, or NULL
+ * @gerror: (out): Location for the GError
+ * @debug: (out): Location for the debug message, or NULL
*
* Extracts the GError and debug string from the GstMessage. The values returned
* in the output arguments are copies; the caller must free them when done.
/**
* gst_message_parse_segment_start:
* @message: A valid #GstMessage of type GST_MESSAGE_SEGMENT_START.
- * @format: Result location for the format, or NULL
- * @position: Result location for the position, or NULL
+ * @format: (out): Result location for the format, or NULL
+ * @position: (out): Result location for the position, or NULL
*
* Extracts the position and format from the segment start message.
*
/**
* gst_message_parse_segment_done:
* @message: A valid #GstMessage of type GST_MESSAGE_SEGMENT_DONE.
- * @format: Result location for the format, or NULL
- * @position: Result location for the position, or NULL
+ * @format: (out): Result location for the format, or NULL
+ * @position: (out): Result location for the position, or NULL
*
* Extracts the position and format from the segment start message.
*
/**
* gst_message_parse_duration:
* @message: A valid #GstMessage of type GST_MESSAGE_DURATION.
- * @format: Result location for the format, or NULL
- * @duration: Result location for the duration, or NULL
+ * @format: (out): Result location for the format, or NULL
+ * @duration: (out): Result location for the duration, or NULL
*
* Extracts the duration and format from the duration message. The duration
* might be GST_CLOCK_TIME_NONE, which indicates that the duration has
/**
* gst_message_parse_async_start:
* @message: A valid #GstMessage of type GST_MESSAGE_ASYNC_DONE.
- * @new_base_time: Result location for the new_base_time or NULL
+ * @new_base_time: (out): Result location for the new_base_time or NULL
*
* Extract the new_base_time from the async_start message.
*
/**
* gst_message_parse_request_state:
* @message: A valid #GstMessage of type GST_MESSAGE_REQUEST_STATE.
- * @state: Result location for the requested state or NULL
+ * @state: (out): Result location for the requested state or NULL
*
* Extract the requested state from the request_state message.
*
/**
* gst_message_parse_stream_status:
* @message: A valid #GstMessage of type GST_MESSAGE_STREAM_STATUS.
- * @type: A pointer to hold the status type
- * @owner: The owner element of the message source
+ * @type: (out): A pointer to hold the status type
+ * @owner: (out): The owner element of the message source
*
* Extracts the stream status type and owner the GstMessage. The returned
* owner remains valid for as long as the reference to @message is valid and
/**
* gst_message_parse_step_done:
* @message: A valid #GstMessage of type GST_MESSAGE_STEP_DONE.
- * @format: result location for the format
- * @amount: result location for the amount
- * @rate: result location for the rate
- * @flush: result location for the flush flag
- * @intermediate: result location for the intermediate flag
- * @duration: result location for the duration
- * @eos: result location for the EOS flag
+ * @format: (out): result location for the format
+ * @amount: (out): result location for the amount
+ * @rate: (out): result location for the rate
+ * @flush: (out): result location for the flush flag
+ * @intermediate: (out): result location for the intermediate flag
+ * @duration: (out): result location for the duration
+ * @eos: (out): result location for the EOS flag
*
* Extract the values the step_done message.
*
/**
* gst_message_parse_step_start:
* @message: A valid #GstMessage of type GST_MESSAGE_STEP_DONE.
- * @active: result location for the active flag
- * @format: result location for the format
- * @amount: result location for the amount
- * @rate: result location for the rate
- * @flush: result location for the flush flag
- * @intermediate: result location for the intermediate flag
+ * @active: (out): result location for the active flag
+ * @format: (out): result location for the format
+ * @amount: (out): result location for the amount
+ * @rate: (out): result location for the rate
+ * @flush: (out): result location for the flush flag
+ * @intermediate: (out): result location for the intermediate flag
*
* Extract the values from step_start message.
*
/**
* gst_message_parse_qos:
* @message: A valid #GstMessage of type GST_MESSAGE_QOS.
- * @live: if the message was generated by a live element
- * @running_time: the running time of the buffer that generated the message
- * @stream_time: the stream time of the buffer that generated the message
- * @timestamp: the timestamps of the buffer that generated the message
- * @duration: the duration of the buffer that generated the message
+ * @live: (out): if the message was generated by a live element
+ * @running_time: (out): the running time of the buffer that generated the message
+ * @stream_time: (out): the stream time of the buffer that generated the message
+ * @timestamp: (out): the timestamps of the buffer that generated the message
+ * @duration: (out): the duration of the buffer that generated the message
*
* Extract the timestamps and live status from the QoS message.
*
/**
* gst_message_parse_qos_values:
* @message: A valid #GstMessage of type GST_MESSAGE_QOS.
- * @jitter: The difference of the running-time against the deadline.
- * @proportion: Long term prediction of the ideal rate relative to normal rate
+ * @jitter: (out): The difference of the running-time against the deadline.
+ * @proportion: (out): Long term prediction of the ideal rate relative to normal rate
* to get optimal quality.
- * @quality: An element dependent integer value that specifies the current
+ * @quality: (out): An element dependent integer value that specifies the current
* quality level of the element. The default maximum quality is 1000000.
*
* Extract the QoS values that have been calculated/analysed from the QoS data
/**
* gst_message_parse_qos_stats:
* @message: A valid #GstMessage of type GST_MESSAGE_QOS.
- * @format: Units of the 'processed' and 'dropped' fields. Video sinks and video
+ * @format: (out): Units of the 'processed' and 'dropped' fields. Video sinks and video
* filters will use GST_FORMAT_BUFFERS (frames). Audio sinks and audio filters
* will likely use GST_FORMAT_DEFAULT (samples).
- * @processed: Total number of units correctly processed since the last state
+ * @processed: (out): Total number of units correctly processed since the last state
* change to READY or a flushing operation.
- * @dropped: Total number of units dropped since the last state change to READY
+ * @dropped: (out): Total number of units dropped since the last state change to READY
* or a flushing operation.
*
* Extract the QoS stats representing the history of the current continuous