diff --git a/gst-libs/gst/audio/gstaudiodecoder.h b/gst-libs/gst/audio/gstaudiodecoder.h index 90d3d0582c..27e1fab6b2 100644 --- a/gst-libs/gst/audio/gstaudiodecoder.h +++ b/gst-libs/gst/audio/gstaudiodecoder.h @@ -215,12 +215,18 @@ struct _GstAudioDecoder * Allows closing external resources. * @negotiate: Optional. * Negotiate with downstream and configure buffer pools, etc. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @decide_allocation: Optional. * Setup the allocation parameters for allocating output * buffers. The passed in query contains the result of the * downstream allocation query. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @propose_allocation: Optional. * Propose buffer allocation parameters for upstream elements. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * * Subclasses can override any of the available virtual methods or not, as * needed. At minimum @handle_frame (and likely @set_format) needs to be diff --git a/gst-libs/gst/audio/gstaudioencoder.h b/gst-libs/gst/audio/gstaudioencoder.h index d989bf974e..e4973affe4 100644 --- a/gst-libs/gst/audio/gstaudioencoder.h +++ b/gst-libs/gst/audio/gstaudioencoder.h @@ -159,12 +159,18 @@ struct _GstAudioEncoder { * Allows closing external resources. * @negotiate: Optional. * Negotiate with downstream and configure buffer pools, etc. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @decide_allocation: Optional. * Setup the allocation parameters for allocating output * buffers. The passed in query contains the result of the * downstream allocation query. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @propose_allocation: Optional. * Propose buffer allocation parameters for upstream elements. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * * Subclasses can override any of the available virtual methods or not, as * needed. At minimum @set_format and @handle_frame needs to be overridden. diff --git a/gst-libs/gst/video/gstvideodecoder.h b/gst-libs/gst/video/gstvideodecoder.h index 26dd86d992..56b0f1d914 100644 --- a/gst-libs/gst/video/gstvideodecoder.h +++ b/gst-libs/gst/video/gstvideodecoder.h @@ -219,18 +219,28 @@ struct _GstVideoDecoder * Event handler on the sink pad. This function should return * TRUE if the event was handled and should be discarded * (i.e. not unref'ed). + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @src_event: Optional. * Event handler on the source pad. This function should return * TRUE if the event was handled and should be discarded * (i.e. not unref'ed). + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @negotiate: Optional. * Negotiate with downstream and configure buffer pools, etc. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @decide_allocation: Optional. * Setup the allocation parameters for allocating output * buffers. The passed in query contains the result of the * downstream allocation query. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @propose_allocation: Optional. * Propose buffer allocation parameters for upstream elements. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * * Subclasses can override any of the available virtual methods or not, as * needed. At minimum @handle_frame needs to be overridden, and @set_format diff --git a/gst-libs/gst/video/gstvideoencoder.h b/gst-libs/gst/video/gstvideoencoder.h index ca9c9cf7a0..da4203652c 100644 --- a/gst-libs/gst/video/gstvideoencoder.h +++ b/gst-libs/gst/video/gstvideoencoder.h @@ -188,18 +188,28 @@ struct _GstVideoEncoder * Event handler on the sink pad. This function should return * TRUE if the event was handled and should be discarded * (i.e. not unref'ed). + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @src_event: Optional. * Event handler on the source pad. This function should return * TRUE if the event was handled and should be discarded * (i.e. not unref'ed). + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @negotiate: Optional. * Negotiate with downstream and configure buffer pools, etc. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @decide_allocation: Optional. * Setup the allocation parameters for allocating output * buffers. The passed in query contains the result of the * downstream allocation query. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * @propose_allocation: Optional. * Propose buffer allocation parameters for upstream elements. + * Subclasses should chain up to the parent implementation to + * invoke the default handler. * * Subclasses can override any of the available virtual methods or not, as * needed. At minimum @handle_frame needs to be overridden, and @set_format