18 Creating and Managing Controllers

18 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.

DESCRIPTION
SPECIAL CONSIDERATIONS

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