www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Free_Sem

Unconditionally free a resource semaphore.   The resource's usage count is set to zero and the resource is freed.

int RTX_Free_Sem ( int semID );

Parameters

semID

The semaphore ID of a resource semaphore acquired by a call to RTX_Create_Sem.

Return Value

0 on success else error code.

Comments

The resource will immediately be given to the task (if any) which is waiting at the head of this semaphore's wait queue.   Task rescheduling occurs immediately if necessary.

This function is similar to RTX_Release_Sem.   The RTX_Release_Sem function unwinds the usage count from nested calls to RTX_Reserve_Sem one count per call.   This RTX_Free_Sem function clears the count, immediately erasing the affect of several nested calls to RTX_Reserve_Sem.

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