Inside Macintosh: Apple Game Sprockets Guide /

Chapter 2 - DrawSprocket / DrawSprocket Reference

DrawSprocket Functions / Choosing a Context and Saving Preferences

DSpContext_GetFlattenedSize

Use the DSpContext_GetFlattenedSize function to find out how much memory is required to store a flattened version of a context.

OSStatus DSpContext_GetFlattenedSize (
DSpContextReference inContext,
UInt32 *outFlatContextSize);

inContext

A reference to the context you intend to flatten.

outFlatContextSize

On exit, the size of the buffer required to store a flattened version of the context.

function result

A result code.

DESCRIPTION

You pass the DSpContext_GetFlattenedSize function a reference to a context in the inContext parameter and it returns, in the outFlatContextSize parameter, the size of the buffer required to store a flattened version of the context. You can then allocate a buffer of this size and pass it to DSpContext_Flatten.

CALLING RESTRICTIONS

Do not call this function during an interrupt.