APTR handle = OpenDir(STRPTR name, int mode, struct hwTagList *tags);
OpenDir()implementation has to check whether your plugin wants to handle this directory or not. If your plugin wants to handle this directory, your
OpenDir()implementation needs to open it and return a handle back to Hollywood. Otherwise
NULL. The handle returned by this function is an opaque data type only your plugin knows about. Hollywood will pass this handle to you whenever it wants to get the next object from this directory.
mode argument is currently unused.
The tag list that Hollywood may pass to
OpenDir() can contain the following items:
pDatawill point to a
struct hwUserTagListcontaining a list of user tags passed by the Hollywood script. User tags are a way of passing additional information from Hollywood scripts to plugin functions. See User tags for details. (V10.0)
pDatawill point to a pointer to a string pointer, i.e.
STRPTR*. Your plugin can set
pDatato a null-terminated string containing a format description of the directory. Hollywood scripts will then be able to get this format name by querying the
#DIRECTORY. Note that the string pointer you write to
pDatamust stay valid for as long as the directory is open. (V10.0)
NULLif your plugin doesn't want to handle this directory