RtkReleaseMutex

RtkReleaseMutex relinquishes ownership of an RTSS mutex.

Syntax

Copy

NTSTATUS RtkReleaseMutex(
    [in]    RTSSINST RtssInst,
    [in]    HANDLE Mutex
);

Parameters

[in] RtssInst

An RTSSINST value returned from a call to RtkRtssAttach or RtkRtssAttachEx. Pass a valid RTSSINST value or the call will fail with STATUS_INVALID_PARAMETER.

[in] Mutex

The handle that identifies the mutex object is returned by a preceding call to RtkCreateMutex or RtkOpenMutex.

Return Value

If the function succeeds, it returns STATUS_SUCCESS. If the function fails, it returns one of the following NTSTATUS error codes:

STATUS_INVALID_PARAMETER
STATUS_UNSUCCESSFUL
STATUS_INVALID_HANDLE

Remarks

RtkReleaseMutex fails if the calling thread does not own the mutex object.

Note: Priority Inversion Prevention is not available with the real-time Kernel API.

Requirements

Minimum supported version	Header	Library	IRQL
wRTOS 1.0 SDK	RtkApi.h	RtkApi_W64.lib	PASSIVE_LEVEL