www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Signal_Events

Signal that one or more events in a group have occurred by setting the event flags.   If any tasks are waiting on these events, the Event Manager will now wake them up.

int RTX_Signal_Events ( unsigned int id,
                        unsigned int event_mask,
                        unsigned int event_value );

Parameters

id

Event group ID produced by RTX_Create_EventGroup call.

event_mask

16-Bit mask identifying the flags of interest in the group

event_value

Event value for the 16 event flag/bits.   Only the bits marked '1' in the event_mask are relevant here.

Return Value

0 on success else error code.

Comments

This function modifies the event group bits marked by ones in the event_mask to either '1' or '0' based on the values of the corresponding bits in the event_value parameter.

Event group bits which are zero in the event_mask are unaffected.

Note that "event occurred" condition can be either a bit '1' or '0'.   This is application defined and is specified by the value supplied to the RTX_Wait_For_Event call.

See Also

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

Related Topics

RTX API   Overview

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3SC2x
    V1.00V1.00V1.00V0.90V1.00

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document