Legacy Document

Inside Macintosh: Processes

Chapter 3 - Time Manager / Time Manager Reference

Time Manager Routines /

InsXTime

Use the InsXTime procedure to install a task if you want to take advantage of the drift-free, fixed-frequency timing services of the extended Time Manager.

PROCEDURE InsXTime (tmTaskPtr: QElemPtr);

tmTaskPtr

A pointer to an extended task record to be installed in the queue.

DESCRIPTION

The InsXTime procedure adds the Time Manager task record specified by tmTaskPtr to the Time Manager queue. The tmTaskPtr parameter must point to an extended Time Manager task record. Your application must fill in the tmAddr field of that task. You should set the tmWakeUp and tmReserved fields to 0 the first time you call InsXTime.

With the extended Time Manager, you can set tmAddr to NIL if you do not want a task to execute when the delay passed to PrimeTime expires. Also, InsXTime resets the high-order bit of the qType field to 0.

ASSEMBLY-LANGUAGE INFORMATION

The registers on entry and exit for InsXTime are:

Registers on entry

A0	Address of the task record

Registers on exit

D0	Result code

RESULT CODES

noErr	0	No error