Plugins that have the capability flag HWPLUG_CAPS_AUDIOADAPTER set can replace Hollywood's
inbuilt audio driver with a customized version. This is a very powerful feature and allows you
to reroute Hollywood's complete audio output through an entirely different backend, thus making
it possible to adapt Hollywood to completely different audio environments.
Please note that audio adapters are not automatically initialized when Hollywood loads
the plugin. Instead, you have to manually call hw_SetAudioAdapter()
in your RequirePlugin() function to activate the audio adapter.
The audio adapter will then only be activated if the user calls @REQUIRE on your
plugin. Otherwise, Hollywood will use its default audio driver. See Auto and manual plugin initialization for details.
See hw_SetAudioAdapter for information on how to install your audio adapter.
Note that audio adapter plugins need not implement all functions offered by its plugin API. Some functions are optional and need only be implemented in specific cases. Here's a list of optional functions:
StartAudioCapture()HWEXT_AUDIOADAPTER_CAPTURE extension flag and the HWSAAFLAGS_CAPTURE flag
in your call to hw_SetAudioAdapter(). See Extension plugins to learn how to use plugin extension bits.
GetAudioCapture()HWEXT_AUDIOADAPTER_CAPTURE extension flag and the HWSAAFLAGS_CAPTURE flag
in your call to hw_SetAudioAdapter(). See Extension plugins to learn how to use plugin extension bits.
StopAudioCapture()HWEXT_AUDIOADAPTER_CAPTURE extension flag and the HWSAAFLAGS_CAPTURE flag
in your call to hw_SetAudioAdapter(). See Extension plugins to learn how to use plugin extension bits.
This plugin type is supported since Hollywood 6.0.