Files
wireplumber/lib/wp/core.h
Julian Bouzas c61d1e4245 component-loader: make wp_core_load_component() API asynchronous
This change completely refactors the way components are loaded in wireplumber:
- The module_init() function must return a GObject now. This object is either
a WpPlugin or a WpSiFactory in the current modules.
- When the component loader initializes a module, it automatically registers
the WpPlugin or WpSiFactory with their respective methods. There is no need
to register the WpPlugin or WpSiFactory in the module now.
- The wp_core_load_component() API has been refactored to be asynchronows. This
allows the component loader to automatically activate WpPlugin objects, and
therefore allows the application to directly get the WpPlugin without having
to find it. This simplifies a lot of things.
- The 'ifexists' and 'nofail' component flags now work even if the respective
WpPlugin could not be activated.
- The code that loads components in main.c has also been simplified a lot,
and the option to load dangling components has also been removed.
2023-04-17 07:48:18 -04:00

134 lines
2.8 KiB
C

/* WirePlumber
*
* Copyright © 2019 Collabora Ltd.
* @author George Kiagiadakis <george.kiagiadakis@collabora.com>
*
* SPDX-License-Identifier: MIT
*/
#ifndef __WIREPLUMBER_CORE_H__
#define __WIREPLUMBER_CORE_H__
#include <gio/gio.h>
#include "defs.h"
#include "properties.h"
G_BEGIN_DECLS
struct pw_context;
struct pw_core;
typedef struct _WpObjectManager WpObjectManager;
/*!
* \brief The WpCore GType
* \ingroup wpcore
*/
#define WP_TYPE_CORE (wp_core_get_type ())
WP_API
G_DECLARE_FINAL_TYPE (WpCore, wp_core, WP, CORE, GObject)
/* Basic */
WP_API
WpCore * wp_core_new (GMainContext *context, WpProperties * properties);
WP_API
WpCore * wp_core_clone (WpCore * self);
WP_API
GMainContext * wp_core_get_g_main_context (WpCore * self);
WP_API
struct pw_context * wp_core_get_pw_context (WpCore * self);
WP_API
struct pw_core * wp_core_get_pw_core (WpCore * self);
WP_API
gchar *wp_core_get_vm_type (WpCore *self);
WP_API
void wp_core_load_component (WpCore * self, const gchar * component,
const gchar * type, GVariant * args, GAsyncReadyCallback callback,
gpointer data);
WP_API
GObject * wp_core_load_component_finish (WpCore * self, GAsyncResult * res,
GError ** error);
/* Connection */
WP_API
gboolean wp_core_connect (WpCore *self);
WP_API
void wp_core_disconnect (WpCore *self);
WP_API
gboolean wp_core_is_connected (WpCore * self);
/* Properties */
WP_API
guint32 wp_core_get_remote_cookie (WpCore * self);
WP_API
const gchar * wp_core_get_remote_name (WpCore * self);
WP_API
const gchar * wp_core_get_remote_user_name (WpCore * self);
WP_API
const gchar * wp_core_get_remote_host_name (WpCore * self);
WP_API
const gchar * wp_core_get_remote_version (WpCore * self);
WP_API
WpProperties * wp_core_get_remote_properties (WpCore * self);
WP_API
WpProperties * wp_core_get_properties (WpCore * self);
WP_API
void wp_core_update_properties (WpCore * self, WpProperties * updates);
/* Callback */
WP_API
void wp_core_idle_add (WpCore * self, GSource **source, GSourceFunc function,
gpointer data, GDestroyNotify destroy);
WP_API
void wp_core_idle_add_closure (WpCore * self, GSource **source,
GClosure * closure);
WP_API
void wp_core_timeout_add (WpCore * self, GSource **source, guint timeout_ms,
GSourceFunc function, gpointer data, GDestroyNotify destroy);
WP_API
void wp_core_timeout_add_closure (WpCore * self, GSource **source,
guint timeout_ms, GClosure * closure);
WP_API
gboolean wp_core_sync (WpCore * self, GCancellable * cancellable,
GAsyncReadyCallback callback, gpointer user_data);
WP_API
gboolean wp_core_sync_closure (WpCore * self, GCancellable * cancellable,
GClosure * closure);
WP_API
gboolean wp_core_sync_finish (WpCore * self, GAsyncResult * res,
GError ** error);
/* Object Manager */
WP_API
void wp_core_install_object_manager (WpCore * self, WpObjectManager * om);
G_END_DECLS
#endif