Q3MemoryStorage_New
You can use theQ3MemoryStorage_New
function to create a new memory storage object.
TQ3StorageObject Q3MemoryStorage_New ( const unsigned char *buffer, unsigned long validSize);
buffer
- A pointer to a buffer in memory, or
NULL
.validSize
- The size, in bytes, of the valid metafile data contained in the specified buffer. If
buffer
is set toNULL
, this parameter specifies the initial size and also the grow size of the buffer that QuickDraw 3D allocates internally.DESCRIPTION
TheQ3MemoryStorage_New
function returns, as its function result, a new memory storage object associated with the data in the buffer specified by thebuffer
andvalidSize
parameters. The data in the specified buffer is copied into internal QuickDraw 3D memory, so you can dispose of the buffer ifQ3MemoryStorage_New
returns successfully.If you pass the value
NULL
in thebuffer
parameter, QuickDraw 3D allocates a buffer ofvalidSize
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. Ifbuffer
is set toNULL
andvalidSize
is set to 0, QuickDraw 3D uses a default initial buffer and grow size.If
Q3MemoryStorage_New
cannot create a new storage object, it returns the valueNULL
.ERRORS
kQ3ErrorOutOfMemory
Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help