Device Definition Structure (GameSprockets)

Inside Macintosh: Apple Game Sprockets Guide /

Chapter 3 - InputSprocket / InputSprocket Reference

Device Definition Structure
A device definition structure provides all the information about the input device available within the system. A device definition structure is defined by the ISpDeviceDefinition data type.
typedef struct ISpDeviceDefinition {
   Str63             deviceName; 
   ISpDeviceClass    theDeviceClass;
   ISpDeviceIdentifier theDeviceIdentifier;
   UInt32            permanentId;                    
   UInt32            flags;
   UInt32            reserved1;
   UInt32            reserved2;
   UInt32            reserved3;
} ISpDeviceDefinition;
Field Description

deviceName
A human readable string with the name of the device.
theDeviceClass
The general category of device--for example, joystick, keyboard, mouse, and so on. There are built-in values for the theDeviceClass parameter, and device driver developers may create new ones. For a list of built-in values see "Built-in Device Categories" (page 3-18).
theDeviceIdentifier
The registered four-character sequence that identifies the type of device.
permanentId
An ID that identifies the device even after rebooting. If the device driver cannot distinguish this device from other devices with the same value for theDeviceIdentifier, this field should be 0.
flags
Status flags.
reserved1
Reserved. Always set this field to 0.
reserved2
Reserved. Always set this field to 0.
reserved3
Reserved. Always set this field to 0.