INtime SDK Help
ntxReleaseRtSemaphore
INtime SDK v7.1 > About INtime > INtime Kernel > Semaphores > ntxReleaseRtSemaphore

Releases units to an RT semaphore. Threads waiting on the RT semaphore may be allowed to run (released) if this call supplies all the units they were waiting for.

NTXSTATUS ntxReleaseRtSemaphore(
    NTXHANDLE hSemaphore,
    WORD wUnits
);

Parameters

hSemaphore
The handle to the RT semaphore.
wUnits
The number of units to send.

Return Values

E_OK
Success.
The status code.
Failure.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_LIMIT 0x0004
The semaphore's maximum unit count would have been exceeded. A semaphore's maximum unit count is determined when it is created.
E_EXIST 0x0006
hSemaphore is not a handle for an existing object.
E_TYPE 0x8002
hSemaphore is not a handle for a semaphore.
E_NTX_INTERNAL_ERROR
The DLL could not contact the RT kernel to complete the request.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/ntx.h ntx.h ntx.lib
INtime 4.01 (for 64-bit Windows) intime/nt/include/ntx.h ntx.h ntx64.lib

See Also

Semaphore system calls