CooCox CoOS User's Guide

Parameters:
[in] muterID
the designated mutex section ID
Returns:
E_CALL, be called in the interrupt service program
E_INVALID_ID, the mutex section ID that was incomed is invalid
E_OK,
enter the mutex section successfully
Example usage:
#include "CCRTOS.h"
OS_MutexID mutex;
void TaskN (void *pdata)
{
...
/* Create a mutex */
mutex = CoCreateMutex ();
/* Enter critical region */
CoEnterMutexSection(mutex);
…
/*Process here */
…
/* Exit critical region */
CoLeaveMutexSection(mutex);
...
}
Note:
1) If high-priority task A attempts to enter the mutex region,the system will
promote the priority of task B which has entered the mutex region
currently to the same level of task A, and change task A’ state to the
waiting state (TASK_WAITING),then do a task scheduling so that the
task B which has entered the mutex region could leave the mutex region
as soon as possible. Task B’ s priority will be back to the original priority.
2)This function can not be used in interrupt service routine.
3)It should be used in pairs with Co LeaveMutexSection().
6.6.3 CoLeaveMutexSection()
Function Prototype:
StatusType CoLeaveMutexSection(
OS_MutexID mutexID
);
Descriptions:
Leave the mutex section whose ID was designated.
Parameters:
78