Name
hw_GetVirtualWriteFileBuffer -- get writable virtual file's buffer (V9.0)
Synopsis
APTR buffer = hw_GetVirtualWriteFileBuffer(APTR handle, ULONG *size,
                  struct hwTagList *tags);
Function
This function can be used to get access to a writable virtual file's underlying memory buffer. You have to pass a handle created by hw_CreateVirtualWriteFile() to this function. The underlying memory buffer will then be returned in buffer. The size of that memory buffer will be written to size. Note that the buffer size isn't necessarily identical to the virtual file's current file size. It will typically be larger.

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.

Designer compatibility
Unsupported

Inputs
handle
writable virtual file handle allocated by hw_CreateVirtualWriteFile()
size
pointer to a ULONG that will receive the virtual file's memory buffer size
tags
reserved for future use, pass NULL for now
Results
buffer
pointer to the virtual file's underlying memory buffer

Show TOC