OSUnlockMutex

Syntax

#include <revolution/os.h>

void OSUnlockMutex(OSMutex* mutex);

Arguments

mutex Pointer to mutex.

Return Values

None.

Description

The calling thread unlocks the mutex. The thread calling this function must be the mutex owner.

If the calling thread has locked this mutex N times, the mutex will actually be released only on the Nth call to the OSUnLockMutex function.

If a thread is called because a higher priority thread requires this mutex, and the priority of that thread is temporarily increased, the priority will be recalculated. (There's a chance that the priority will not be restored to its original state because it depends on other mutexes being saved.)

If the mutex has been freed, all threads blocked by this mutex will be put into an executable state and run in order of their priority.

See Also

Thread Functions, Thread Synchronization Functions, OSInitCond, OSInitMutex, OSLockMutex, OSSignalCond, OSTryLockMutex, OSWaitCond

Revision History

2006/03/01 Initial version.


CONFIDENTIAL