Gstreamer插件教程2.4—编写一个插件(Writing a Plugin)：event函数(The event function)

英文原文：https://gstreamer.freedesktop.org/documentation/plugin-development/basics/eventfn.html

event函数通知你发生在数据流上的特殊事件（如caps, end-of-stream, newsegment, tags等）。events可以往上游传送，也可以下游传送，所以你即可以在sink pads中，也可以在source pads中收到它们。

下面是一个非常简单的event函数，我们可以在我们的element中安装它：

static gboolean gst_my_filter_sink_event (GstPad    *pad,
                                          GstObject *parent,
                                          GstEvent  *event);

[..]

static void
gst_my_filter_init (GstMyFilter * filter)
{
[..]
  /* configure event function on the pad before adding
   * the pad to the element */
  gst_pad_set_event_function (filter->sinkpad,
      gst_my_filter_sink_event);
[..]
}

static gboolean
gst_my_filter_sink_event (GstPad    *pad,
                  GstObject *parent,
                  GstEvent  *event)
{
  gboolean ret;
  GstMyFilter *filter = GST_MY_FILTER (parent);

  switch (GST_EVENT_TYPE (event)) {
    case GST_EVENT_CAPS:
      /* we should handle the format here */

      /* push the event downstream */
      ret = gst_pad_push_event (filter->srcpad, event);
      break;
    case GST_EVENT_EOS:
      /* end-of-stream, we should close down all stream leftovers here */
      gst_my_filter_stop_processing (filter);

      ret = gst_pad_event_default (pad, parent, event);
      break;
    default:
      /* just call the default handler */
      ret = gst_pad_event_default (pad, parent, event);
      break;
  }
  return ret;
}

对于一些未知的events，调用默认的event处理函数 gst_pad_event_default()是一个不错的主意。根据event类型，默认的处理将向前传送event或简单的unref它。CAPS event默认是不向前传送的，所以我们需要在自己的element中处理它。