Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /
Chapter 16 - Storage Objects / Storage Objects Reference
Storage Objects Routines / Creating and Accessing Handle Storage Objects


Q3HandleStorage_New

You can use the Q3HandleStorage_New function to create a new handle storage object.

TQ3StorageObject Q3HandleStorage_New (
Handle handle, 
unsigned long validSize);
handle
A handle to a buffer in memory, or NULL.
validSize
The size, in bytes, of the specified buffer.
DESCRIPTION
The Q3HandleStorage_New function returns, as its function result, a new handle storage object associated with the buffer specified by the handle and validSize parameters. Your application must not access that buffer until the associated storage object is closed or disposed of. If Q3HandleStorage_New cannot create a new storage object, it returns the value NULL. If you pass the value NULL in the handle parameter, QuickDraw 3D allocates a buffer of the specified size and later disposes of that buffer when the associated storage object is closed or disposed of.

ERRORS
kQ3ErrorOutOfMemory


Previous Book Contents Book Index Next

© Apple Computer, Inc.
11 JUL 1996




Navigation graphic, see text links

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help