[media] v4l2-event: add optional merge and replace callbacks

When the event queue for a subscribed event is full, then the oldest
event is dropped. It would be nice if the contents of that oldest
event could be merged with the next-oldest. That way no information is
lost, only intermediate steps are lost.

This patch adds optional replace() (called when only one kevent was allocated)
and merge() (called when more than one kevent was allocated) callbacks that
will be called to do this job.

These two callbacks are implemented for the V4L2_EVENT_CTRL event.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>

1 files changed, 6 insertions, 0 deletions

diff --git a/include/media/v4l2-event.h b/include/media/v4l2-event.h
index 8d681e5ca552..6da793fa4d34 100644
--- a/include/media/v4l2-event.h
+++ b/include/media/v4l2-event.h
@@ -55,6 +55,12 @@ struct v4l2_subscribed_event {
         struct v4l2_fh          *fh;
         /* list node that hooks into the object's event list (if there is one) */
         struct list_head        node;
+        /* Optional callback that can replace event 'old' with event 'new'. */
+        void                    (*replace)(struct v4l2_event *old,
+                                           const struct v4l2_event *new);
+        /* Optional callback that can merge event 'old' into event 'new'. */
+        void                    (*merge)(const struct v4l2_event *old,
+                                         struct v4l2_event *new);
         /* the number of elements in the events array */
         unsigned                elems;
         /* the index of the events containing the oldest available event */