Skip to content

AudioWeaver Plugins

Modules

Name
Creating a Plugin
Using the AudioWeaver Plugin API to create a dynamically loadable list of modules.
Loading a Plugin
Using the AudioWeaver Plugin API to load plugin libraries.

Classes

Name
struct _AWEPluginModuleArray
A list of module classes provided by a plugin.
struct _AWEPlugin
A struct encapsulating the functionality which can be provided by a plugin library.
struct _awe_PluginCallbacks
Callbacks passed by the loader to each plugin entrypoint.

Types

Name
typedef struct _AWEPluginModuleArray AWEPluginModuleArray
A list of module classes provided by a plugin.
typedef struct _AWEPlugin AWEPlugin
A struct encapsulating the functionality which can be provided by a plugin library.
typedef struct _awe_PluginCallbacks awe_PluginCallbacks
Callbacks passed by the loader to each plugin entrypoint.

Defines

Name
AWE_PLUGIN_API_VERSION_MAX_LENGTH
Maximum length of the AWE_PLUGIN_API_VERSION.
AWE_PLUGIN_API_VERSION
Version of the AudioWeaver Plugin API.

Types Documentation

typedef AWEPluginModuleArray

typedef struct _AWEPluginModuleArray AWEPluginModuleArray;

A list of module classes provided by a plugin.

typedef AWEPlugin

typedef struct _AWEPlugin AWEPlugin;

A struct encapsulating the functionality which can be provided by a plugin library.

This struct is to be returned by the plugin's AWEPlugin_initialize entrypoint. Optional fields can be set to NULL.

typedef awe_PluginCallbacks

typedef struct _awe_PluginCallbacks awe_PluginCallbacks;

Callbacks passed by the loader to each plugin entrypoint.

The plugin entrypoint should prefer to use these functions during initialization. They are guaranteed to outlive the plugin, so it is safe to cache them internally. This is typically necessary if memory is to be freed in the plugin's cleanup function. They may be NULL, in which case the plugin entrypoint must either choose to use a fallback or simply return NULL to indicate an initialization failure.

Macros Documentation

define AWE_PLUGIN_API_VERSION_MAX_LENGTH

#define AWE_PLUGIN_API_VERSION_MAX_LENGTH 63

Maximum length of the AWE_PLUGIN_API_VERSION.

This does not include the null-terminator.

define AWE_PLUGIN_API_VERSION

#define AWE_PLUGIN_API_VERSION "1"

Version of the AudioWeaver Plugin API.

Must be a null-terminated character string with length less than AWE_PLUGIN_API_VERSION_MAX_LENGTH.


Updated on 2026-02-10 at 15:44:29 -0500