plugin-loader.h
Go to the documentation of this file.
/* Simple Plugin API
*
* Copyright © 2021 Wim Taymans
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice (including the next
* paragraph) shall be included in all copies or substantial portions of the
* Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
#ifndef SPA_PLUGIN_LOADER_H
#define SPA_PLUGIN_LOADER_H
#ifdef __cplusplus
extern "C" {
#endif
#include <spa/utils/hook.h>
#include <spa/utils/dict.h>
#define SPA_TYPE_INTERFACE_PluginLoader SPA_TYPE_INFO_INTERFACE_BASE "PluginLoader"
#define SPA_VERSION_PLUGIN_LOADER 0
struct spa_plugin_loader { struct spa_interface iface; };
struct spa_plugin_loader_methods {
#define SPA_VERSION_PLUGIN_LOADER_METHODS 0
uint32_t version;
struct spa_handle *(*load) (void *object, const char *factory_name, const struct spa_dict *info);
int (*unload)(void *object, struct spa_handle *handle);
};
static inline struct spa_handle *
spa_plugin_loader_load(struct spa_plugin_loader *loader, const char *factory_name, const struct spa_dict *info)
{
struct spa_handle *res = NULL;
if (SPA_LIKELY(loader != NULL))
spa_interface_call_res(&loader->iface,
struct spa_plugin_loader_methods, res,
load, 0, factory_name, info);
return res;
}
static inline int
spa_plugin_loader_unload(struct spa_plugin_loader *loader, struct spa_handle *handle)
{
int res = -1;
if (SPA_LIKELY(loader != NULL))
spa_interface_call_res(&loader->iface,
struct spa_plugin_loader_methods, res,
unload, 0, handle);
return res;
}
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* SPA_PLUGIN_LOADER_H */
spa_interface_call_res
#define spa_interface_call_res(iface, method_type, res, method, vers,...)
Invoke method named method in the callbacks on the given interface object.
Definition: hook.h:255
spa_plugin_loader_load
static struct spa_handle * spa_plugin_loader_load(struct spa_plugin_loader *loader, const char *factory_name, const struct spa_dict *info)
Definition: plugin-loader.h:80
spa_plugin_loader_unload
static int spa_plugin_loader_unload(struct spa_plugin_loader *loader, struct spa_handle *handle)
Definition: plugin-loader.h:91
SPA_LIKELY
#define SPA_LIKELY(x)
Definition: defs.h:313
hook.h
spa/utils/hook.h
spa_dict
Definition: dict.h:59
spa_handle
Definition: plugin.h:50
spa_interface
Definition: hook.h:158
spa_plugin_loader_methods
Definition: plugin-loader.h:56
spa_plugin_loader_methods::unload
int(* unload)(void *object, struct spa_handle *handle)
Unload a SPA plugin.
Definition: plugin-loader.h:76
spa_plugin_loader_methods::version
uint32_t version
Definition: plugin-loader.h:59
spa_plugin_loader
Definition: plugin-loader.h:54
spa_plugin_loader::iface
struct spa_interface iface
Definition: plugin-loader.h:54
dict.h
spa/utils/dict.h