APTR handle = hw_CreateVirtualWriteFile(STRPTR buf, int bufsize, struct hwTagList *tags);
After hw_CreateVirtualWriteFile()
returns, you can pass the file name
it has written to buf
to hw_FOpen() to open the
file for writing. Then you can write to it using hw_FWrite()
and other DOS functions. Virtual files will behave exactly as normal files
so you will also have to call hw_FClose() when you're
done with them.
Finally, you have to free all resources associated to the writable virtual file by calling hw_FreeVirtualWriteFile(). This must be done after closing the virtual file using hw_FClose().
Note that writable virtual files must never be used in your ClosePlugin() function because at that time the handler that controls writable virtual files inside Hollywood will no longer be there.
buf
in bytes (must be at least 1024)NULL
for nowNULL
on error