Additionally, application routines can invoke this routine to setup timers which will be triggered in Uface context.
This routine works by creating a message which looks like a message from another task.
Note that the response routine is invoked in uface context, but you should call DitsUfaceCtxEnable to install a new response routine before initiating messages to other tasks. Alternately, you can signal an action using DitsSignal().
In the ResponseRoutine, DitsGetReason will return a type of DITS_REA_RESCHED and DitsGetEntInfo will return the transaction id returned by this routine.
Before the timer has gone off, the transation id can be supplied to DitsUfaceTimerCancel to cancel the timer.
| > | delay | DitsDeltaTimeType * | The delay before the timeout occurs. If a null pointer is supplied, a zero second timer is used. |
|---|---|---|---|
| > | ResponseRoutine | DitsActionRoutineType | The routine to be called. See Dits documentation for details. If zero, the this value and the code are taken from the current Uface Context Response Routine as set by DitsUfaceCtxEnable. If not in Uface context, then this routine Must be supplied. |
| > | code | long int | Will be returned by DitsGetCode in the response routine. Only used if Response Routine is supplied, otherwise the current value supplied to DitsUfaceCtxEnable is used. |
| < | transid | DitsTransIdType * | Transaction id for the transaction started. If a null pointer is supplied, no transaction id is returned. |
| ! | status | StatusType * | Modified status.
|
| ! | status | StatusType * | Modified status. The
handler function should set status bad when it fails
|
|---|---|---|---|
| Dits___TransIdCreate | Dits Internal | Create a transaction id |
|---|---|---|
| Dits___TransIdDelete | Dits Internal | Delete a transaction id |
| ImpQueueReminder | Imp | Queue a reminder message |
Click here for the DRAMA home page and here for the AAO home page.
For more information, contact tony.farrell@mq.edu.au