Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Processes
Chapter 3 - Time Manager / Time Manager Reference
Time Manager Routines /


RmvTime

Use the RmvTime procedure to remove a task from the Time Manager queue.

PROCEDURE RmvTime (tmTaskPtr: QElemPtr);
tmTaskPtr
A pointer to a task record to be removed from the queue.
DESCRIPTION
The RmvTime procedure removes the Time Manager task record specified by tmTaskPtr from the Time Manager queue. In both the revised and extended Time Managers, if the specified task record is active (that is, if it has been activated but the specified time has not yet elapsed), the tmCount field of the task record returns the amount of time remaining. To provide the greatest accuracy, the unused time is reported as negated microseconds if that value is small enough to fit into the tmCount field (even if the delay was originally specified in milliseconds); otherwise, the unused time is reported in positive milliseconds. If the time has already expired, tmCount contains 0.

In the revised and extended Time Managers, RmvTime sets the high-order bit of the qType field to 0.

ASSEMBLY-LANGUAGE INFORMATION
The registers on entry and exit for RmvTime are:

Registers on entry

A0	Address of the task record
Registers on exit
D0	Result code

RESULT CODES
noErr	0	No error


Previous Book Contents Book Index Next

© Apple Computer, Inc.
17 JUN 1996