Inside Macintosh: Apple Game Sprockets Guide /

Chapter 3 - InputSprocket / InputSprocket Reference

InputSprocket Functions / Configuring the Application

ISpElement_NewVirtual

You can use the ISpElement_NewVirtual function to create a single virtual element for an element with data of a certain size.

OSStatus ISpElement_NewVirtual (
	UInt32 dataSize,
	ISpElementReference *outElement;
	UInt32 flags);

dataSize

The size of the data.

outElement

On exit, a reference to the virtual element.

flags

Set the kISpVirtualElementFlag_UseTempMem bit to tell InputSprocket to allocate the virtual element in temporary memory. See "Virtual Element Flag" (page 3-23).

function result

A result code.

DESCRIPTION

You pass the ISpElement_NewVirtual function the size of the data in the dataSize parameter and it returns, in the outElement parameter, a reference to a virtual element that can be allocated to an element whose data is that size. If you want the virtual element allocated in temporary memory pass kISpVirtualElementFlag_UseTempMem in the flags parameter.