mirror of
https://gitlab.freedesktop.org/pipewire/wireplumber.git
synced 2025-12-20 15:50:03 +01:00
22ab3c938f
Allow marking WpSpaDevice object ids "pending", which means Props from any ObjectConfig events received for the ids are saved, if there is no associated object set yet. When wp_spa_device_store_managed_object() is called, any pending Props are set on the managed object. This is useful when nodes cannot be immediately created in the "create-object" signal handler. For example, in cases where the nodes are created asynchronously, e.g. by "module-loopback". In this case, although the nodes can be later associated with the WpSpaDevice, any ObjectConfig events received in the meantime are lost, so for example restoring saved Routes will race against async node creation. Using wp_spa_device_set_managed_pending() solves this race condition.
75 lines
1.7 KiB
C
75 lines
1.7 KiB
C
/* WirePlumber
|
|
*
|
|
* Copyright © 2019 Collabora Ltd.
|
|
* @author Julian Bouzas <julian.bouzas@collabora.com>
|
|
*
|
|
* SPDX-License-Identifier: MIT
|
|
*/
|
|
|
|
#ifndef __WIREPLUMBER_DEVICE_H__
|
|
#define __WIREPLUMBER_DEVICE_H__
|
|
|
|
#include "global-proxy.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/* WpDevice */
|
|
|
|
/*!
|
|
* \brief The WpDevice GType
|
|
* \ingroup wpdevice
|
|
*/
|
|
#define WP_TYPE_DEVICE (wp_device_get_type ())
|
|
WP_API
|
|
G_DECLARE_FINAL_TYPE (WpDevice, wp_device, WP, DEVICE, WpGlobalProxy)
|
|
|
|
WP_API
|
|
WpDevice * wp_device_new_from_factory (WpCore * core,
|
|
const gchar * factory_name, WpProperties * properties);
|
|
|
|
/* WpSpaDevice */
|
|
|
|
/*!
|
|
* \brief Flags to be used as WpObjectFeatures for WpSpaDevice
|
|
* \ingroup wpspadevice
|
|
*/
|
|
typedef enum { /*< flags >*/
|
|
/*! enables a spa device */
|
|
WP_SPA_DEVICE_FEATURE_ENABLED = (WP_PROXY_FEATURE_CUSTOM_START << 0),
|
|
} WpSpaDeviceFeatures;
|
|
|
|
/*!
|
|
* \brief The WpSpaDevice GType
|
|
* \ingroup wpspadevice
|
|
*/
|
|
#define WP_TYPE_SPA_DEVICE (wp_spa_device_get_type ())
|
|
WP_API
|
|
G_DECLARE_FINAL_TYPE (WpSpaDevice, wp_spa_device, WP, SPA_DEVICE, WpProxy)
|
|
|
|
WP_API
|
|
WpSpaDevice * wp_spa_device_new_wrap (WpCore * core,
|
|
gpointer spa_device_handle, WpProperties * properties);
|
|
|
|
WP_API
|
|
WpSpaDevice * wp_spa_device_new_from_spa_factory (WpCore * core,
|
|
const gchar * factory_name, WpProperties * properties);
|
|
|
|
WP_API
|
|
WpProperties * wp_spa_device_get_properties (WpSpaDevice * self);
|
|
|
|
WP_API
|
|
WpIterator * wp_spa_device_new_managed_object_iterator (WpSpaDevice * self);
|
|
|
|
WP_API
|
|
GObject * wp_spa_device_get_managed_object (WpSpaDevice * self, guint id);
|
|
|
|
WP_API
|
|
void wp_spa_device_store_managed_object (WpSpaDevice * self, guint id,
|
|
GObject * object);
|
|
|
|
WP_API
|
|
void wp_spa_device_set_managed_pending (WpSpaDevice * self, guint id);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif
|