//如果一個(gè)臨界區(qū)太長(zhǎng)而不適合簡(jiǎn)單地關(guān)中斷來(lái)實(shí)現(xiàn)，可以考慮采用掛起調(diào)度器的方式。但是喚醒(resuming, or un-suspending)調(diào)度器卻是一個(gè)
//相對(duì)較長(zhǎng)的操作。所以評(píng)估哪種是最佳方式需要結(jié)合實(shí)際情況。如果某個(gè)中斷在調(diào)度器掛起過(guò)程中要求進(jìn)行上下文切換，則個(gè)這請(qǐng)求也會(huì)被
//掛起，直到調(diào)度器被喚醒后才會(huì)得到執(zhí)行
void vTaskSuspendAll( void )
{
//通過(guò)掛起調(diào)度器來(lái)創(chuàng)建臨界區(qū),掛起調(diào)度器有些時(shí)候也被稱(chēng)為鎖定調(diào)度器
++uxSchedulerSuspended;//系統(tǒng)維護(hù)一個(gè)uxSchedulerSuspended計(jì)數(shù)值，當(dāng)其大于0時(shí)表示禁止調(diào)度；等于0時(shí)則表示允許調(diào)度。
//返回值 在調(diào)度器掛起過(guò)程中，上下文切換請(qǐng)求也會(huì)被掛起，直到調(diào)度器被喚醒后才會(huì)得到執(zhí)行。
//如果一個(gè)掛起的上下文切換請(qǐng)求在xTaskResumeAll()返回前得到執(zhí)行，則函數(shù)返回pdTRUE，表示CPU要求被搶占，
//在其它情況下，xTaskResumeAll()返回pdFALSE，然后根據(jù)返回值，強(qiáng)制使任務(wù)交出CPU（或者叫做任務(wù)切換）
}

//如果一個(gè)臨界區(qū)太長(zhǎng)而不適合簡(jiǎn)單地關(guān)中斷來(lái)實(shí)現(xiàn)，可以考慮采用掛起調(diào)度器的方式。但是喚醒(resuming, or un-suspending)調(diào)度器卻是一個(gè)
//相對(duì)較長(zhǎng)的操作。所以評(píng)估哪種是最佳方式需要結(jié)合實(shí)際情況。如果某個(gè)中斷在調(diào)度器掛起過(guò)程中要求進(jìn)行上下文切換，則個(gè)這請(qǐng)求也會(huì)被
//掛起，直到調(diào)度器被喚醒后才會(huì)得到執(zhí)行
BaseType_t xTaskResumeAll ( void )
{
TCB_t *pxTCB;
BaseType_t xAlreadyYielded = pdFALSE;
//在禁止調(diào)度任務(wù)期間，若ISR導(dǎo)致了一個(gè)任務(wù)的就緒，這個(gè)任務(wù)就會(huì)放到xPendingReadyList中，
//一旦調(diào)度允許，必須把所有xPendingReadyList中的任務(wù)移動(dòng)到一個(gè)合適的就緒鏈表中。
//要考慮調(diào)度器被掛起時(shí)，放在xPendingReadyList鏈表中的任務(wù)
taskENTER_CRITICAL();//關(guān)中斷，進(jìn)入臨界區(qū)
{
--uxSchedulerSuspended;//調(diào)度器掛起計(jì)數(shù)器減一操作，如果仍大于0，則不止一個(gè)任務(wù)使調(diào)度器掛起;直到調(diào)度器不再掛起，則進(jìn)入以下操作
if( uxSchedulerSuspended == ( UBaseType_t ) pdFALSE )
{
if( uxCurrentNumberOfTasks > ( UBaseType_t ) 0U )
{
//目前正在運(yùn)行的任務(wù)數(shù)是否大于0，如果大于0，則進(jìn)入以下操作，否則跳出本函數(shù)
//移除所有的被調(diào)度器掛起時(shí)就緒的任務(wù)，進(jìn)入合適的就緒鏈表，直到xPendingReadyList鏈表為空
while( listLIST_IS_EMPTY( &xPendingReadyList ) == pdFALSE )
{
pxTCB = ( TCB_t * ) listGET_OWNER_OF_HEAD_ENTRY( ( &xPendingReadyList ) );
( void ) uxListRemove( &( pxTCB->xEventListItem ) );
( void ) uxListRemove( &( pxTCB->xGenericListItem ) );
prvAddTaskToReadyList( pxTCB );
//我們轉(zhuǎn)移的任務(wù)是否有比當(dāng)前任務(wù)的優(yōu)先級(jí)高的，如果有，則搶占申請(qǐng)成功，進(jìn)行任務(wù)切換
if( pxTCB->uxPriority >= pxCurrentTCB->uxPriority )//新獲取任務(wù)的優(yōu)先級(jí)不低于當(dāng)前任務(wù)的優(yōu)先級(jí)
{
xYieldPending = pdTRUE;//任務(wù)切換被使能
}
else
{
mtCOVERAGE_TEST_MARKER();
}
}
//在調(diào)度器被掛起的時(shí)間之內(nèi)，是否有丟失未處理的滴答數(shù)。uxMissedTicks是丟失的滴答數(shù)
if( uxPendedTicks > ( UBaseType_t ) 0U )//若在任務(wù)掛起了則其值的改變?cè)谛奶鴷r(shí)鐘中++。若大于0說(shuō)明有丟失的時(shí)鐘數(shù)。
{
while( uxPendedTicks > ( UBaseType_t ) 0U )
{
if( xTaskIncrementTick() != pdFALSE ) //模擬進(jìn)入心跳時(shí)鐘中斷，若!pdFALSE則說(shuō)明進(jìn)行任務(wù)切換。即：補(bǔ)齊缺失的滴答數(shù)。
{
xYieldPending = pdTRUE;//允許任務(wù)切換
}
else
{
mtCOVERAGE_TEST_MARKER();
}
--uxPendedTicks;//將丟失的時(shí)鐘數(shù)--，保證其準(zhǔn)確性。
}
}
else
{
mtCOVERAGE_TEST_MARKER();
}

if( xYieldPending == pdTRUE )//若允許任務(wù)切換
{
#if( configUSE_PREEMPTION != 0 )//若使用搶占式的系統(tǒng)
{
xAlreadyYielded = pdTRUE;//返回值設(shè)為已經(jīng)切換成功
}
#endif
taskYIELD_IF_USING_PREEMPTION();//啟用搶占式的方式進(jìn)行任務(wù)切換
}
else
{
mtCOVERAGE_TEST_MARKER();
}
}
}
else
{
mtCOVERAGE_TEST_MARKER();
}
}
taskEXIT_CRITICAL();

return xAlreadyYielded;//返回任務(wù)是否已經(jīng)切換；已經(jīng)切換返回pdTRUE；反之返回pdFALSE。
}