INtime SDK Help
knDeleteRtSemaphore
INtime SDK v6 > About INtime > INtime Kernel > Semaphores > knDeleteRtSemaphore

Deletes a low-level semaphore. All threads waiting at the semaphore are awakened with the E_KN_NONEXIST status code.

Note: as with all low-level objects, the object itself is not deleted but waiting threads are signaled as described. Subsequently threads can again wait on the semaphore or send it units.

If a low-level region is deleted while a thread has access to it, that thread is no longer guarded by the low-level region. Any dynamic adjustments that were made to that thread's priority as a result of accessing the low-level region are nullified, the thread resumes its static priority, and may be preempted. Because the low-level region no longer exists, the thread must not release the low-level region's unit back to the region.

Note:   Do not use this call in an interrupt handler.
VOID knDeleteRtSemaphore(

KNHANDLE hSemaphore // handle for low-level semaphore
);

Parameters

hSemaphore
RT handle for a low-level semaphore.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rtbase.h rt.h rt.lib

See Also

Semaphore system calls, E_KN_NONEXIST