Legacy Document

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

Chapter 3 - Time Manager / Time Manager Reference

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