Legacy Document

Inside Macintosh: PowerPC System Software /

Chapter 2 - Mixed Mode Manager / Mixed Mode Manager Reference

Mixed Mode Manager Routines / Creating and Disposing of Routine Descriptors

DisposeRoutineDescriptor

You can call the DisposeRoutineDescriptor function to dispose of a routine descriptor.

pascal void DisposeRoutineDescriptor 
                                 (UniversalProcPtr theProcPtr);

theProcPtr

A universal procedure pointer.

DESCRIPTION

The DisposeRoutineDescriptor function disposes of the routine descriptor pointed to by the theProcPtr parameter. You should call this function to release any memory allocated by a previous call to NewRoutineDescriptor.

The Operating System automatically disposes of any remaining routine descriptors held by your application when ExitToShell is executed on its behalf. As a result, you don't need to explicitly dispose of any routine descriptors that you have allocated in your application heap.

SPECIAL CONSIDERATIONS

Be careful not to dispose of a routine descriptor that is still in use by the Operating System. Code that installs completion routines or other routines called asynchronously may complete before the completion routine is actually called.

When the USESROUTINEDESCRIPTORS compile flag is false, the DisposeRoutineDescriptor function does nothing.