Inside Macintosh: Apple Game Sprockets Guide /

Chapter 3 - InputSprocket / InputSprocket Reference

InputSprocket Functions / Managing Element Lists

ISpElementList_AddElements

You can use the ISpElementList_AddElements function to add more elements to an element list.

OSStatus ISpElementList_AddElements (
	ISpElementListReference inElementList,
	UInt32 refCon,
	UInit32 count,
	ISpElementReference *newElements);

inElementList

A reference to the element list you want to add elements to.

refCon

A reference constant used to locate the new elements in the element list.

count

The number of elements to be added.

newElements

A pointer to a block of element references.

function result

A result code.

DESCRIPTION

The ISpElementList_AddElements function adds the number of elements specified in the count parameter to the element list referred to by the inElementList parameter. It takes the new elements from the block of references pointed to by the newElements parameter. The function returns a reference constant in the refCon parameter to use in identifying the new elements in the list.

CALLING RESTRICTIONS

Do not call ISpElementList_AddElements at interrupt time.