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.

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