Name
hw_SetIPCAdapter -- install an IPC adapter (V9.0)
Synopsis
int error = hw_SetIPCAdapter(hwPluginBase *self, ULONG flags,
                struct hwTagList *tags);
Function
This function can be used to activate a plugin that has the HWPLUG_CAPS_IPCADAPTER capability flag set. This function must only be called from inside your RequirePlugin() implementation. If this function succeeds, Hollywood's inbuilt IPC handler will be completely replaced by the IPC handler provided by your plugin and Hollywood will call into your plugin whenever it needs to do inter-process communication. In the first parameter, you have to pass a pointer to the hwPluginBase that Hollywood has passed to your plugin's InitPlugin() function. The second parameter must be set to a combination of flags. The following flags are currently defined:

HWSIAFLAGS_PERMANENT:
If this flag is set, the IPC adapter will be made permanent. This means that other plugins won't be able to overwrite this IPC adapter with their own one. If HWSIAFLAGS_PERMANENT is set, all subsequent calls to hw_SetIPCAdapter() will fail and your IPC adapter will persist.

See IPC adapter plugins for information on how to write IPC adapter plugins.

Designer compatibility
Unsupported

Inputs
self
hwPluginBase pointer passed to InitPlugin()
flags
combination of flags (see above)
tags
reserved for future use; set it to NULL for now
Results
error
error code or 0 for success
Show TOC