request-pad: tell about ref counts in release_request_pad docs.

It is not too obvious that getting and releasing request pads is not entierly
symetrical regarding to the pad refcount. Add a note about that to the docs.
This might deserve a FIXME-0.11 too.
This commit is contained in:
Stefan Kost 2009-06-26 12:50:53 +03:00
parent 31ff42de21
commit fdcde50cb0

View file

@ -327,6 +327,10 @@ gst_element_default_error (GObject * object, GstObject * source, GError * error,
* Makes the element free the previously requested pad as obtained
* with gst_element_get_request_pad().
*
* This does not unref the pad. If the pad was created by using
* gst_element_get_request_pad(), gst_element_release_request_pad() needs to be
* followed by gst_object_unref() to free the @pad.
*
* MT safe.
*/
void