16 Creating and Accessing Handle Storage Objects

16 Q3HandleStorage_Set

You can use the Q3HandleStorage_Set function to set information about a handle storage object.

TQ3Status Q3HandleStorage_Set (
TQ3StorageObject storage, 
Handle handle, 
unsigned long validSize);
storage A handle storage object.
handle A handle to a contiguous block of memory to be associated with the specified storage object, or NULL.
validSize The size, in bytes, of the specified buffer.

DESCRIPTION


The Q3HandleStorage_Set function sets the buffer location and size of the handle storage object specified by the storage parameter to the values specified in the handle and validSize parameters. If you pass the value NULL in the handle parameter, QuickDraw3D allocates a buffer of the specified size and later disposes of that buffer when the associated storage object is closed or disposed of. If you pass NULL in handle and 0 in validSize, QuickDraw3D allocates a buffer of a private default size.

SPECIAL CONSIDERATIONS


You must not use Q3HandleStorage_Set with an open handle storage object.

ERRORS


kQ3ErrorInvalidObjectParameter

DESCRIPTION
SPECIAL CONSIDERATIONS
ERRORS

3D Graphics Programming with QuickDraw 3D - 17 OCT 1995

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker