Inside Macintosh: Apple Game Sprockets Guide /

Chapter 3 - InputSprocket / InputSprocket Reference

InputSprocket Functions / Obtaining Data From Elements

ISpElement_GetSimpleState

Use the ISpElement_GetSimpleState function to obtain the current state of an element whose data fits in an unsigned 32-bit integer.

OSStatus ISpElement_GetSimpleState (
	const ISpElementReference inElement,
	Uint32 *state);

inElement

A reference to the element whose state you want to get.

state

The current state of the specified element. For a description of some values that may be returned, see "Button Element Data Information" (page 3-21), "Directional Pad Element Data Information" (page 3-21), and "Axis Element Data Information" (page 3-22).

function result

A result code.

DESCRIPTION

The ISpElement_GetSimpleState function gets the current state of the element specified in the inElement parameter and stores it in the location indicated by the state parameter. This function is a specialized version of ISpElement_GetComplexState in that it is only useful with elements whose data fits in an unsigned 32-bit integer.