Previous

Next

Function RTKSignal

Function RTKSignal stores an event in a semaphore.

void RTKSignal(RTKSemaphore S);

Parameters

S

References the semaphore to store the event.

If one or more tasks are waiting at the semaphore, the task with the highest priority is made Ready. If its priority is higher than that of the calling task, it is activated immediately. If the semaphore has type ST_EVENT, all waiting tasks are released.

If no task is waiting at the semaphore, the event is stored. A counting semaphore can store up to 2³²-1 events. The application should make sure that this limit is not exceeded. Binary and event semaphores ignore additional events if they already contain one.

Attempting to set a resource or mutex semaphore to a value > 1 using RTKSignal is considered an error. In this case, the Debug Version will issue an error message and abort the program; in the Standard Version, the results are unpredictable.

If S is a resource or mutex semaphore, the priority of the active task is re-evaluated following the rules of priority inheritance.

Function RTKResourceOwner

Function RTKPulse