16 Creating and Accessing Memory Storage Objects
Q3MemoryStorage_Set
function to set the data of a memory storage object.
TQ3Status Q3MemoryStorage_Set ( TQ3StorageObject storage, const unsigned char *buffer, unsigned long validSize);storage
A memory storage object.buffer
A pointer to a contiguous block of memory to be associated with the specified storage object, orNULL
.validSize
The size, in bytes, of the valid metafile data contained in the specified buffer. Ifbuffer
is set toNULL
, this parameter specifies the initial size and also the grow size of the buffer that QuickDraw3D allocates internally.
Q3MemoryStorage_Set
function sets the data for the memory storage object specified by the storage
parameter to the values specified in the buffer
and validSize
parameters. The data in the specified buffer is copied into internal QuickDraw3D memory, so you can dispose of the buffer if Q3MemoryStorage_Set
returns successfully.
If you pass the value NULL
in the buffer
parameter, QuickDraw3D allocates a buffer of validSize
bytes, increases the buffer by that size whenever necessary, and later disposes of the buffer when the associated storage object is closed or disposed of. If buffer
is set to NULL
and validSize
is set to 0, and if the buffer
parameter was set to NULL
when the storage object was created, QuickDraw3D uses a default initial buffer and grow size.
Q3MemoryStorage_Set
with an open memory storage object.kQ3ErrorAccessRestricted
kQ3ErrorInvalidObjectParameter
Let us know what you think of these prototype pages.
Generated with Harlequin WebMaker