Internal clients run inside the JACK server process. They can use
most of the same functions as external clients. Each internal
client is built as a shared object module, which must declare
jack_initialize() and jack_finish() entry points called at load and
unload times. See @ref inprocess.c for an example.
@param client loading JACK client's handle.
@param client_name of at most jack_client_name_size() characters
for the internal client to load. The name scope is local to the
current server.
@param options formed by OR-ing together @ref JackOptions bits.
Only the @ref JackLoadOptions bits are valid.
@param status (if non-NULL) an address for JACK to return
information from the load operation. This status word is formed by
OR-ing together the relevant @ref JackStatus bits.
<b>Optional parameters:</b> depending on corresponding [@a options
bits] additional parameters may follow @a status (in this order).
@arg [@ref JackLoadName] <em>(char *) load_name</em> is the shared
object file from which to load the new internal client (otherwise
use the @a client_name).
@arg [@ref JackLoadInit] <em>(char *) load_init</em> an arbitary
string passed to the internal client's jack_initialize() routine
(otherwise NULL), of no more than @ref JACK_LOAD_INIT_LIMIT bytes.
@return Opaque internal client handle if successful. If this is 0,
the load operation failed, the internal client was not loaded, and
@a *status includes the @ref JackFailure bit.
Load an internal client into the JACK server.
Internal clients run inside the JACK server process. They can use most of the same functions as external clients. Each internal client is built as a shared object module, which must declare jack_initialize() and jack_finish() entry points called at load and unload times. See @ref inprocess.c for an example.
@param client loading JACK client's handle.
@param client_name of at most jack_client_name_size() characters for the internal client to load. The name scope is local to the current server.
@param options formed by OR-ing together @ref JackOptions bits. Only the @ref JackLoadOptions bits are valid.
@param status (if non-NULL) an address for JACK to return information from the load operation. This status word is formed by OR-ing together the relevant @ref JackStatus bits.
<b>Optional parameters:</b> depending on corresponding [@a options bits] additional parameters may follow @a status (in this order).
@arg [@ref JackLoadName] <em>(char *) load_name</em> is the shared object file from which to load the new internal client (otherwise use the @a client_name).
@arg [@ref JackLoadInit] <em>(char *) load_init</em> an arbitary string passed to the internal client's jack_initialize() routine (otherwise NULL), of no more than @ref JACK_LOAD_INIT_LIMIT bytes.
@return Opaque internal client handle if successful. If this is 0, the load operation failed, the internal client was not loaded, and @a *status includes the @ref JackFailure bit.