int error = hw_SetRequesterAdapter(hwPluginBase *self, ULONG flags, struct hwTagList *tags);
HWPLUG_CAPS_REQUESTERADAPTERcapability flag set. This function must only be called from inside your RequirePlugin() implementation. If this function succeeds, Hollywood's inbuilt requester handler will be completely replaced by the requester handler provided by your plugin. In the first parameter, you have to pass a pointer to the
hwPluginBasethat Hollywood has passed to your plugin's InitPlugin() function. The second parameter must be set to a combination of flags.
Please note that Hollywood will only call your plugin for the requester types that your plugin has
explicitly declared as supported by setting the respective flag (see below). This way
it is possible that your plugin chooses to replace only a certain set of Hollywood's requesters
and not all of them. For example, if your plugin just wants to override Hollywood's file and
path requesters, then you would have to set the
flags below. In that case, Hollywood would only call your plugin when it has to show a
file or path requester - all other types would be handled by Hollywood itself.
The following flags are currently recognized:
HWSRAFLAGS_PERMANENTis set, all subsequent calls to
hw_SetRequesterAdapter()will fail and your requester adapter will persist.
See Requester adapter plugins for information on how to write requester adapter plugins.
hwPluginBasepointer passed to InitPlugin()