xSemaphoreGiveRecursive

[Semaphores]

semphr. h

xSemaphoreGiveRecursive( xSemaphoreHandle xMutex )

　mutex タイプセマフォの再帰的リリース、あるいは「give」するマクロ。 mutex はそれ以前にxSemaphoreCreateRecursiveMutex ()で作成したものです；
　このマクロを利用可能とするためFreeRTOSConfig.h のconfigUSE_RECURSIVE_MUTEXESを１にセットしなくてはなりません。このマクロは xSemaphoreCreateMutex () で作成された mutexes 上では使用できません。再帰的mutex は繰り返して所有者によって「taken」することができます。 所有者が xSemaphoreGiveRecursive () を成功した「take」リクエスト分コールするまでmutex は再び利用可能になりません 例えば、もしタスクが成功裏に同じ mutex を５回「takes」した時、同じく正確に５回 mutex を「given」するまで、 mutex は他のいかなるタスクも利用可能にはならない。

パラメータ：
xMutex
　リリース、あるいは「given」している mutex へのハンドル。 これは xSemaphoreCreateRecursiveMutex () によって返されるハンドルです。

リターン：
pdTRUE
　もしセマフォが成功裏にgivenしたなら。

使用例：

 xSemaphoreHandle xMutex = NULL;

 // A task that creates a mutex.
 void vATask( void * pvParameters )
 {
    // Create the mutex to guard a shared resource.
    xMutex = xSemaphoreCreateRecursiveMutex();
 }

 // A task that uses the mutex.
 void vAnotherTask( void * pvParameters )
 {
    // ... Do other things.

    if( xMutex != NULL )
    {
        // See if we can obtain the mutex.  If the mutex is not available
        // wait 10 ticks to see if it becomes free.    
        if( xSemaphoreTakeRecursive( xMutex, ( portTickType ) 10 ) == pdTRUE )
        {
            // We were able to obtain the mutex and can now access the
            // shared resource.

            // ...
            // For some reason due to the nature of the code further calls to 
            // xSemaphoreTakeRecursive() are made on the same mutex.  In real
            // code these would not be just sequential calls as this would make
            // no sense.  Instead the calls are likely to be buried inside
            // a more complex call structure.
            xSemaphoreTakeRecursive( xMutex, ( portTickType ) 10 );
            xSemaphoreTakeRecursive( xMutex, ( portTickType ) 10 );

            // The mutex has now been 'taken' three times, so will not be 
            // available to another task until it has also been given back
            // three times.  Again it is unlikely that real code would have
            // these calls sequentially, it would be more likely that the calls
            // to xSemaphoreGiveRecursive() would be called as a call stack
            // unwound.  This is just for demonstrative purposes.
            xSemaphoreGiveRecursive( xMutex );
            xSemaphoreGiveRecursive( xMutex );
            xSemaphoreGiveRecursive( xMutex );

            // Now the mutex can be taken by other tasks.
        }
        else
        {
            // We could not obtain the mutex and can therefore not access
            // the shared resource safely.
        }
    }
 }