BOOL osReleaseMutex( HANDLE Handle );
The handle of the mutex object to be released.
Returns TRUE on success or FALSE on failure. To retrieve extended error information, call the osGetLastError function.
This function releases ownership of the specified mutex object.
Mutexes are synchronization primitives used to manage access to critical sections. Code protected by a mutex-controlled critical section is guaranteed to be executed by no more than one task at any given time.
When a task no longer requires exclusive access to a resource, it must release the mutex using the osReleaseMutex function. If other tasks are currently waiting for this object, the next task in the waiting queue will acquire ownership. For more information regarding mutex ownership, please refer to the mutex objects section.
This function will fail if the calling task is not the current owner of the mutex object.
This function is available only when the OS_USE_MUTEX configuration constant is set to 1.
| Version: | 1.0 |
|---|---|
| Header file: | OS_Mutex.h (include OS_API.h) |
| See also: | BOOL, FALSE, HANDLE, mutexes, osCreateMutex, osGetLastError, TRUE |