query: fix gst_query_parse_nth_allocation_pool() annotation
authorTim-Philipp Müller <tim.muller@collabora.co.uk>
Wed, 18 Jul 2012 11:30:59 +0000 (12:30 +0100)
committerTim-Philipp Müller <tim.muller@collabora.co.uk>
Wed, 18 Jul 2012 11:30:59 +0000 (12:30 +0100)
It returns a ref to the pool.

gst/gstquery.c

index 786691c..021c527 100644 (file)
@@ -1547,12 +1547,14 @@ gst_query_get_n_allocation_pools (GstQuery * query)
  * gst_query_parse_nth_allocation_pool:
  * @query: A valid #GstQuery of type GST_QUERY_ALLOCATION.
  * @index: index to parse
- * @pool: (out) (allow-none) (transfer none): the #GstBufferPool
+ * @pool: (out) (allow-none) (transfer full): the #GstBufferPool
  * @size: (out) (allow-none): the size
  * @min_buffers: (out) (allow-none): the min buffers
  * @max_buffers: (out) (allow-none): the max buffers
  *
  * Get the pool parameters in @query.
+ *
+ * Unref @pool with gst_object_unref() when it's not needed any more.
  */
 void
 gst_query_parse_nth_allocation_pool (GstQuery * query, guint index,