RtInitializeFastSemaphore

RtInitializeFastSemaphore initializes a fast semaphore object.

Syntax

Copy

BOOL RtInitializeFastSemaphore(
    [in]    PRTFAST_SEMAPHORE pSemaphore, 
    [in]    ULONG releaseCount 
);

Parameters

[in] pSemaphore

A pointer to a user allocated RTFAST_SEMAPHORE structure.

[in] releasecount

Used to determine when waiters are released. If releaseCount is:

Zero: the semaphore requires a manual release of waiters.
Non-zero: All waiters are automatically released when the number of waiters reaches releaseCount.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. Call GetLastError to obtain an error code.

Remarks

A fast semaphore provides signaling functionality without relying on the RTSS thread library. The result is shorter latency as use of this fast semaphore does not require the waking up of threads.

Requirements

Minimum supported version	Header	Library
wRTOS 1.0 SDK	RtssApi.h	Startup.lib