18 Creating and Managing Controllers

18 Q3Controller_Decommission

You can use the Q3Controller_Decommission function to make a controller inactive.

TQ3Status Q3Controller_Decommission (
TQ3ControllerRef controllerRef);
controllerRef
A reference to a controller.

DESCRIPTION


The Q3Controller_Decommission function makes the controller specified by the controllerRef parameter inactive. Any remaining references to a controller that has been decommissioned are still valid, but the controller is no longer operational. (In other words, when the specified controller is referred to by an application or process other than the one that created it, reasonable default values are returned, not kQ3Failure.) Decommissioning a controller might cause the notify function of the tracker currently associated with the specified controller to be called.

SPECIAL CONSIDERATIONS


The Q3Controller_Decommission function should be called only by the application or process that created the specified 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