18 Creating and Managing Controllers

18 Q3Controller_New

You can use the Q3Controller_New function to create a new controller.

TQ3ControllerRef Q3Controller_New (
const TQ3ControllerData *controllerData);
controllerData
A pointer to a controller data structure.

DESCRIPTION


The Q3Controller_New function returns, as its function result, a reference to a new controller object having the characteristics specified by the controllerData parameter. The new controller object is initially made active and is associated with the system cursor's tracker. You can call Q3Controller_SetTracker to associate the controller with some other tracker. The serial number of the new controller object is set to 1. If Q3Controller_New cannot create a new controller, it returns NULL.

You cannot delete a controller, but you can make it no longer operational. See the description of Q3Controller_Decommission (page 18-15) for details.

SPECIAL CONSIDERATIONS


In general, you need to use this function only if you are writing a device driver for a controller.

SEE ALSO


See "Controller Data Structure" on page 18-12 for a description of the fields of the controller data structure.

DESCRIPTION
SPECIAL CONSIDERATIONS
SEE ALSO

3D Graphics Programming with QuickDraw 3D - 21 OCT 1995

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker