OS_EVENT *OSMboxCreate (void *msg) { OS_EVENT *pevent; OS_ENTER_CRITICAL(); pevent = OSEventFreeList; if (OSEventFreeList != (OS_EVENT *)0) { OSEventFreeList = (OS_EVENT *)OSEventFreeList->OSEventPtr; } OS_EXIT_CRITICAL(); if (pevent != (OS_EVENT *)0) { pevent->OSEventType = OS_EVENT_TYPE_MBOX; (1) pevent->OSEventPtr = msg; (2) OSEventWaitListInit(pevent); } return (pevent); (3) }
仔細(xì)看看，其實(shí)和創(chuàng)建一個(gè)信號(hào)量的過程幾乎是一樣的，先申請(qǐng)一個(gè)空事件控制塊，接著初始化這個(gè)事件控制塊。最后返回一個(gè)指向這個(gè)事件控制塊的指針。不同之處在于事件控制塊的類型被設(shè)置成OS_EVENT_TYPE_MBOX[ (1)]，以及使用.OSEventPtr域來容納消息指針。
接著來看看等待郵箱函數(shù)實(shí)現(xiàn)代碼：
void *OSMboxPend (OS_EVENT *pevent, INT16U timeout, INT8U *err) { void *msg; OS_ENTER_CRITICAL(); if (pevent->OSEventType != OS_EVENT_TYPE_MBOX) { (1) OS_EXIT_CRITICAL(); *err = OS_ERR_EVENT_TYPE; return ((void *)0); } msg = pevent->OSEventPtr; if (msg != (void *)0) { (2) pevent->OSEventPtr = (void *)0; (3) OS_EXIT_CRITICAL(); *err = OS_NO_ERR; } else if (OSIntNesting > 0) { (4) OS_EXIT_CRITICAL(); *err = OS_ERR_PEND_ISR; } else { OSTCBCur->OSTCBStat |= OS_STAT_MBOX; (5) OSTCBCur->OSTCBDly = timeout; OSEventTaskWait(pevent); OS_EXIT_CRITICAL(); OSSched(); OS_ENTER_CRITICAL(); if ((msg = OSTCBCur->OSTCBMsg) != (void *)0) { (6) OSTCBCur->OSTCBMsg = (void *)0; OSTCBCur->OSTCBStat = OS_STAT_RDY; OSTCBCur->OSTCBEventPtr = (OS_EVENT *)0; OS_EXIT_CRITICAL(); *err = OS_NO_ERR; } else if (OSTCBCur->OSTCBStat & OS_STAT_MBOX) { (7) OSEventTO(pevent); (8) OS_EXIT_CRITICAL(); msg = (void *)0; (9) *err = OS_TIMEOUT; } else { msg = pevent->OSEventPtr; (10) pevent->OSEventPtr = (void *)0; (11) OSTCBCur->OSTCBEventPtr = (OS_EVENT *)0; (12) OS_EXIT_CRITICAL(); *err = OS_NO_ERR; } } return (msg); }
同樣，它和OSSemPend()也很相似，說白了就是先看有沒有有用的消息，要是沒有，就把該任務(wù)掛起來。
OSMboxPend()首先檢查該事件控制塊是由OSMboxCreate()函數(shù)建立的[ (1)]。當(dāng).OSEventPtr域是一個(gè)非NULL的指針時(shí)，說明該郵箱中有可用的消息[ (2)]。這種情況下，OSMboxPend()函數(shù)將該域的值復(fù)制到局部變量msg中，然后將.OSEventPtr置為NULL[ (3)]。這正是我們所期望的，也是執(zhí)行OSMboxPend()函數(shù)最快的路徑。
如果此時(shí)郵箱中沒有消息是可用的（OSEventPtr域是NULL指針），OSMboxPend()函數(shù)檢查它的調(diào)用者是否是中斷服務(wù)子程序[ (4)]。象OSSemPend()函數(shù)一樣，不能在中斷服務(wù)子程序中調(diào)用OSMboxPend()，因?yàn)橹袛喾?wù)子程序是不能等待的。這里的代碼同樣是為了以防萬一。但是，如果郵箱中有可用的消息，即使從中斷服務(wù)子程序中調(diào)用OSMboxPend()函數(shù)，也一樣是成功的。
如果郵箱中沒有可用的消息，OSMboxPend()的調(diào)用任務(wù)就被掛起，直到郵箱中有了消息或者等待超時(shí)[ (5)]。當(dāng)有其它的任務(wù)向該郵箱發(fā)送了消息后（或者等待時(shí)間超時(shí)），這時(shí)，該任務(wù)再一次成為最高優(yōu)先級(jí)任務(wù)，OSSched()返回。這時(shí)，OSMboxPend()函數(shù)要檢查是否有消息被放到該任務(wù)的任務(wù)控制塊中[ (6)]。如果有，那么該次函數(shù)調(diào)用成功，對(duì)應(yīng)的消息被返回到調(diào)用函數(shù)。
發(fā)送一個(gè)消息到郵箱中OSMboxPost()的代碼如下：
INT8U OSMboxPost (OS_EVENT *pevent, void *msg) { OS_ENTER_CRITICAL(); if (pevent->OSEventType != OS_EVENT_TYPE_MBOX) { (1) OS_EXIT_CRITICAL(); return (OS_ERR_EVENT_TYPE); } if (pevent->OSEventGrp) { (2) OSEventTaskRdy(pevent, msg, OS_STAT_MBOX); (3) OS_EXIT_CRITICAL(); OSSched(); (4) return (OS_NO_ERR); } else { if (pevent->OSEventPtr != (void *)0) { (5) OS_EXIT_CRITICAL(); return (OS_MBOX_FULL); } else { pevent->OSEventPtr = msg; (6) OS_EXIT_CRITICAL(); return (OS_NO_ERR); } } }
發(fā)送一個(gè)消息到郵箱和發(fā)送一個(gè)信號(hào)量也很相似，就是查看有沒有任務(wù)在等待這個(gè)消息，如果有就把那個(gè)任務(wù)從睡眠態(tài)拉回就緒態(tài)。
代碼的詳細(xì)解釋如下：
檢查了事件控制塊是否是一個(gè)郵箱后[ (1)]，OSMboxPost()函數(shù)還要檢查是否有任務(wù)在等待該郵箱中的消息[ (2)]。如果事件控制塊中的OSEventGrp域包含非零值，就暗示著有任務(wù)在等待該消息。這時(shí)，調(diào)用OSEventTaskRdy()將其中的最高優(yōu)先級(jí)任務(wù)從等待列表中刪除[ (3)]，加入系統(tǒng)的就緒任務(wù)列表中，準(zhǔn)備運(yùn)行。然后，調(diào)用OSSched()函數(shù)[ (4)]，檢查該任務(wù)是否是系統(tǒng)中最高優(yōu)先級(jí)的就緒任務(wù)。如果是，執(zhí)行任務(wù)切換[僅當(dāng)OSMboxPost()函數(shù)是由任務(wù)調(diào)用時(shí)]，該任務(wù)得以執(zhí)行。如果該任務(wù)不是最高優(yōu)先級(jí)的任務(wù)，OSSched()返回，OSMboxPost()的調(diào)用函數(shù)繼續(xù)執(zhí)行。如果沒有任何任務(wù)等待該消息，指向消息的指針就被保存到郵箱中[ (6)]（假設(shè)此時(shí)郵箱中的指針不是非NULL的[ (5)]）。這樣，下一個(gè)調(diào)用OSMboxPend()函數(shù)的任務(wù)就可以立刻得到該消息了。
如果，你對(duì)上面的內(nèi)容還有疑問，推薦選擇三五互聯(lián)企業(yè)云郵箱！有專人協(xié)助您解答郵箱疑問。
三五互聯(lián)是專業(yè)企業(yè)郵箱的官方正規(guī)提供商，21年行業(yè)經(jīng)驗(yàn)，提供安全穩(wěn)定，簡(jiǎn)單易用，高性價(jià)比的企業(yè)郵箱，按需自由定制，不限空間，極速收發(fā)，能夠滿足用戶對(duì)企業(yè)郵箱的不同需求。可以通過以下幾種方式注冊(cè)、申請(qǐng)、購(gòu)買、試用、開通企業(yè)郵箱：
1、登錄http://m.shinetop.cn/services/mail/在線咨詢申請(qǐng)?jiān)囉没蛸?gòu)買；
2、直接致電028-62778877申請(qǐng)?jiān)囉没蛘劫?gòu)買開通；
