RtReleaseFastSemaphore

RtReleaseFastSemaphore releases the specified count of threads waiting on the fast semaphore. If the number of waiting threads is less than the specified count, RtReleaseFastSemaphore will store the remaining count value and continue to release new threads that call RtAcquireFastSemaphore on this fast semaphore.

Declaration

BOOL RtReleaseFastSemaphore(
    PRTFAST_SEMPHORE pSemaphore, 
    LONG count
)

Parameters

pSemaphore

A pointer to a user allocated RTFAST_SEMAPHORE structure.

count

A count of threads that should be released from the busy wait state.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE.

To get any extended error information, call GetLastError.

Remarks

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

See Also:

• RtInitializeFastSemaphore
• RtGetCountFastSemaphore
• RtAcquireFastSemaphore
• RtReleaseAllFastSemaphore