RtInitializeFastSemaphore

RtInitializeFastSemaphore initializes a fast semaphore object.

Syntax

BOOL RtInitializeFastSemaphore(
    PRTFAST_SEMAPHORE pSemaphore, 
    ULONG releaseCount 
);

Parameters

pSemaphore

A pointer to a user allocated RTFAST_SEMAPHORE structure.

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.

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

• RtGetCountFastSemaphore
• RtAcquireFastSemaphore
• RtReleaseFastSemaphore
• RtReleaseAllFastSemaphore