DitsMsgWait - Wait until a message arrives and return before processing
it.
Function
Wait until a message arrives and return before processing it.
Description
This routine will block until a DRAMA message is available
for the task. If will then return prior to processing that
message such that DitsMsgReceive() can then process the message.
This is not required as DitsMsgReceive() will block to wait for
the message, but can be useful if you need to do something
(take a semaphore) between reception and processing of a message.
This makes use the message peeking facility, so the first message
to arrive will be considered peeked at and therefore not accessible
to the DitsPeek(3) routine.
Language
C
Call
(void) = DitsMsgWait (status)
Parameters
(">" input, "!" modified, "W"
workspace, "<" output)
|
! | status | StatusType * | Modified status.
|
|---|
|
Include files
DitsSys.h
External functions used
|
ImpReadPtr | Imp |
Wait for a message.
|
|---|
|
ImpReadEnd | Imp |
Indication completion of read.
|
|---|
|
External values used
DitsTask - Details of the current task
Prior requirements
DitsAppInit should have been called.
See Also
The Dits Specification Document, DitsMsgReceive(3),
DitsMainLoop(3), DitsMsgAvail(3), DitsPeek(3).
Support
Tony Farrell, AAO
Click here for the DRAMA home page and
here for the AAO home page.
For more information, contact tony.farrell@mq.edu.au