Legacy Document

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