Important: The information in this document is obsolete and should not be used for new development.
PrimeTimeprocedure to activate a task in the Time Manager queue.
PROCEDURE PrimeTime (tmTaskPtr: QElemPtr; count: LongInt);
- A pointer to a task record already installed in the queue.
- The desired delay before execution of the task.
PrimeTimeprocedure schedules the task specified by the
tmTaskPtrfor execution after the delay specified by the
countparameter has elapsed.
countparameter is a positive value, it is interpreted as milliseconds. If
countis a negative value, it is interpreted in negated microseconds. (Microsecond delays are allowable only in the revised and extended Time Managers.)
The task record specified by
tmTaskPtrmust already be installed in the queue (by a previous call to
InsXTime) before your application calls
PrimeTimereturns immediately, and the specified task is executed after the specified delay has elapsed. If you call
PrimeTimewith a time delay of 0, the task runs as soon as interrupts are enabled.
In the revised and extended Time Managers,
PrimeTimesets the high-order bit of the
qTypefield to 1. In addition, any value of the
countparameter that exceeds the maximum millisecond delay is reduced to the maximum. If you stop an unexpired task (by calling
RmvTime) and then reinstall it (by calling
InsXTime), you can continue the previous delay by calling
countparameter set to 0.
ASSEMBLY-LANGUAGE INFORMATIONThe registers on entry and exit for
Registers on entryA0 Address of the task record D0 Specified delay time (long)Registers on exitD0 Result code
RESULT CODESnoErr 0 No error