wireplumber/lib/wp/event-dispatcher.h
Ashok Sidipotu ff833b138d event-dispatcher: log event and hook names and chains
- Add a new variable "name" in WpEventHook and use it to log all the
  hooks(by name) picked up in _push_event(). This gives a clear picture
  if hook is registered for a given event.
- Form a name for an event and a chain of events for an event run, log
  both of them. This gives a clear picture of the events executed and
  order in which they are dispatched.
- Similarly build hooks chain and print it in _source_dispatch(), this
  gives a clear picture of the hooks picked and the order in which they
  are dispatched.
- Log only the dispatchable(with hooks) events, this de-clutters
  the log messages.
2023-04-17 07:47:09 -04:00

84 lines
1.9 KiB
C

/* WirePlumber
*
* Copyright © 2022 Collabora Ltd.
* @author George Kiagiadakis <george.kiagiadakis@collabora.com>
*
* SPDX-License-Identifier: MIT
*/
#ifndef __WIREPLUMBER_EVENT_DISPATCHER_H__
#define __WIREPLUMBER_EVENT_DISPATCHER_H__
#include "properties.h"
#include "event-hook.h"
#include "core.h"
G_BEGIN_DECLS
/*! \defgroup wpevent WpEvent */
/*!
* \struct WpEvent
*
* WpEvent describes an event, an event is an entity which can be pushed on to
* event stack and the event dispatcher is going to pick and dispatch it.
*
*/
#define WP_TYPE_EVENT (wp_event_get_type ())
WP_API
GType wp_event_get_type (void) G_GNUC_CONST;
typedef struct _WpEvent WpEvent;
WP_API
WpEvent * wp_event_new (const gchar * type, gint priority,
WpProperties * properties, GObject * source, GObject * subject);
WP_API
WpEvent * wp_event_ref (WpEvent * self);
WP_API
void wp_event_unref (WpEvent * self);
WP_API
WpProperties * wp_event_get_properties (WpEvent * self);
WP_API
GObject * wp_event_get_source (WpEvent * self);
WP_API
GObject * wp_event_get_subject (WpEvent * self);
WP_API
void wp_event_stop_processing (WpEvent * self);
G_DEFINE_AUTOPTR_CLEANUP_FUNC (WpEvent, wp_event_unref)
/*! \defgroup wpeventdispatcher WpEventDispatcher */
/*!
* \struct WpEventDispatcher
*
* The event dispatcher holds all the events and hooks and dispatches them. It orchestras the show on event stack.
*/
#define WP_TYPE_EVENT_DISPATCHER (wp_event_dispatcher_get_type ())
WP_API
G_DECLARE_FINAL_TYPE (WpEventDispatcher, wp_event_dispatcher,
WP, EVENT_DISPATCHER, GObject)
WP_API
WpEventDispatcher * wp_event_dispatcher_get_instance (WpCore * core);
WP_API
void wp_event_dispatcher_push_event (WpEventDispatcher * self, WpEvent * event);
WP_API
void wp_event_dispatcher_register_hook (WpEventDispatcher * self,
WpEventHook * hook);
WP_API
void wp_event_dispatcher_unregister_hook (WpEventDispatcher * self,
WpEventHook * hook);
G_END_DECLS
#endif