@CHIP-RTOS C Library V2.00 - RTOS API
RTX_Wait_For_Event
The calling task waits until the Event Manager
wakes it up (the event has occurred) or the specified timeout is
reached. int RTX_Wait_For_Event ( unsigned int id,
RTX_Wait_Event far *event_ptr ); Parameters
id
- Event group ID produced by
RTX_Create_EventGroup
call.
event_ptr
- Pointer to RTX_Wait_Event
structure
filled in by caller.
Return Value
- 0 on success else
error code.
Comments
- Note that the Event Manager's wakeup mechanism is level sensitive
(not edge triggered). Consequently, a task may want to acknowledge
an event bit level after a wakeup by negating the flag using the
RTX_Signal_Events function
following a wakeup.
The alternative RTX_Wait_For_EventP
function is identical to this function, except for parameter passing
method.
The RTX_Get_Saved_Events
function can be used to pick up the event states.
See Also
RTOS API
- This library function invokes a RTOS software interrupt.
Refer to this RTOS API function's
documentation
for more details.
This API List
List of C Libraries
@CHIP-RTOS Main Index
End of document
|