BaseSrc: fix transfer annotation for fixate virtual method
authorMathieu Duponchelle <mathieu@centricular.com>
Fri, 27 Jan 2023 18:29:24 +0000 (19:29 +0100)
committerGStreamer Marge Bot <gitlab-merge-bot@gstreamer-foundation.org>
Sat, 28 Jan 2023 19:20:29 +0000 (19:20 +0000)
The fixate virtual method has the same semantics as gst_caps_fixate(),
so the caps parameter must be marked as (transfer full).

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/3839>

subprojects/gstreamer/libs/gst/base/gstbasesrc.h

index b1612dc..4207ffc 100644 (file)
@@ -184,6 +184,14 @@ struct _GstBaseSrcClass {
   /* decide on caps */
   gboolean      (*negotiate)    (GstBaseSrc *src);
   /* called if, in negotiation, caps need fixating */
+  /**
+   * GstBaseSrcClass::fixate:
+   * @caps: (transfer full):
+   *
+   * Called if, in negotiation, caps need fixating.
+   *
+   * Returns: (transfer full): the fixated caps
+   */
   GstCaps *     (*fixate)       (GstBaseSrc *src, GstCaps *caps);
   /* notify the subclass of new caps */
   gboolean      (*set_caps)     (GstBaseSrc *src, GstCaps *caps);