Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /
Chapter 18 - QuickDraw 3D Pointing Device Manager / QuickDraw 3D Pointing Device Manager Reference
QuickDraw 3D Pointing Device Manager Routines / Creating and Managing Controllers


Q3Controller_SetActivation

You can use the Q3Controller_SetActivation function to set the activation state of a controller.

TQ3Status Q3Controller_SetActivation (
TQ3ControllerRef controllerRef, 
TQ3Boolean active);
controllerRef
A reference to a controller.
active
A Boolean value that indicates whether the specified controller is to be made active (kQ3True) or inactive (kQ3False).
DESCRIPTION
The Q3Controller_SetActivation function sets the activation state of the controller specified by the controllerRef parameter to the value specified in the active parameter. If the activation state of a controller is changed, the serial number of the list of available controllers is incremented. A controller should be inactive if it is temporarily off-line.

The notify function of the tracker currently associated with the specified controller might be called when Q3Controller_SetActivation is called.

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


Previous Book Contents Book Index Next

© Apple Computer, Inc.
11 JUL 1996




Navigation graphic, see text links

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help