Inside Macintosh: Apple Game Sprockets Guide /

Chapter 3 - InputSprocket / InputSprocket Reference

InputSprocket Functions / Configuring the Application

ISpDevices_Extract

You can use the ISpDevices_Extract function to extract and count devices listed on the systemwide list of devices. This may be useful if you want to find and deactivate input devices--usually the keyboard and mouse--prior to autoconfiguration.

OSStatus ISpDevices_Extract (
	UInt32 inBufferCount,
	UInt32 *outCount,
	ISpDeviceReference *buffer);

inBufferCount

The number of device references in the array pointed to by the buffer parameter.

outCount

The number of device references on the systemwide list.

buffer

A pointer to an array of device references.

function result

A result code.

DESCRIPTION

The ISpDevices_Extract function takes, in the buffer parameter, a pointer to an array of device references and, in the inBufferCount parameter, the number of device references in the array. The ISpDevices_Extract function copies device references from the systemwide list of devices into that array. If there are more devices in the list than there is space in your array, it copies only as many device references as fit. The function returns the total number of devices in the system wide list of devices in the outCount parameter.