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

See Also

Semaphore system calls