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) }
仔細看看，其實和創(chuàng)建一個信號量的過程幾乎是一樣的，先申請一個空事件控制塊，接著初始化這個事件控制塊。最后返回一個指向這個事件控制塊的指針。不同之處在于事件控制塊的類型被設置成OS_EVENT_TYPE_MBOX[ (1)]，以及使用.OSEventPtr域來容納消息指針。
接著來看看等待郵箱函數(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()也很相似，說白了就是先看有沒有有用的消息，要是沒有，就把該任務掛起來。
OSMboxPend()首先檢查該事件控制塊是由OSMboxCreate()函數(shù)建立的[ (1)]。當.OSEventPtr域是一個非NULL的指針時，說明該郵箱中有可用的消息[ (2)]。這種情況下，OSMboxPend()函數(shù)將該域的值復制到局部變量msg中，然后將.OSEventPtr置為NULL[ (3)]。這正是我們所期望的，也是執(zhí)行OSMboxPend()函數(shù)最快的路徑。
如果此時郵箱中沒有消息是可用的（OSEventPtr域是NULL指針），OSMboxPend()函數(shù)檢查它的調用者是否是中斷服務子程序[ (4)]。象OSSemPend()函數(shù)一樣，不能在中斷服務子程序中調用OSMboxPend()，因為中斷服務子程序是不能等待的。這里的代碼同樣是為了以防萬一。但是，如果郵箱中有可用的消息，即使從中斷服務子程序中調用OSMboxPend()函數(shù)，也一樣是成功的。
如果郵箱中沒有可用的消息，OSMboxPend()的調用任務就被掛起，直到郵箱中有了消息或者等待超時[ (5)]。當有其它的任務向該郵箱發(fā)送了消息后（或者等待時間超時），這時，該任務再一次成為最高優(yōu)先級任務，OSSched()返回。這時，OSMboxPend()函數(shù)要檢查是否有消息被放到該任務的任務控制塊中[ (6)]。如果有，那么該次函數(shù)調用成功，對應的消息被返回到調用函數(shù)。
發(fā)送一個消息到郵箱中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ā)送一個消息到郵箱和發(fā)送一個信號量也很相似，就是查看有沒有任務在等待這個消息，如果有就把那個任務從睡眠態(tài)拉回就緒態(tài)。
代碼的詳細解釋如下：
檢查了事件控制塊是否是一個郵箱后[ (1)]，OSMboxPost()函數(shù)還要檢查是否有任務在等待該郵箱中的消息[ (2)]。如果事件控制塊中的OSEventGrp域包含非零值，就暗示著有任務在等待該消息。這時，調用OSEventTaskRdy()將其中的最高優(yōu)先級任務從等待列表中刪除[ (3)]，加入系統(tǒng)的就緒任務列表中，準備運行。然后，調用OSSched()函數(shù)[ (4)]，檢查該任務是否是系統(tǒng)中最高優(yōu)先級的就緒任務。如果是，執(zhí)行任務切換[僅當OSMboxPost()函數(shù)是由任務調用時]，該任務得以執(zhí)行。如果該任務不是最高優(yōu)先級的任務，OSSched()返回，OSMboxPost()的調用函數(shù)繼續(xù)執(zhí)行。如果沒有任何任務等待該消息，指向消息的指針就被保存到郵箱中[ (6)]（假設此時郵箱中的指針不是非NULL的[ (5)]）。這樣，下一個調用OSMboxPend()函數(shù)的任務就可以立刻得到該消息了。
如果，你對上面的內容還有疑問，推薦選擇西部數(shù)碼企業(yè)云郵箱！有專人協(xié)助您解答郵箱疑問。
西部數(shù)碼是專業(yè)企業(yè)郵箱的官方正規(guī)提供商，21年行業(yè)經驗，提供安全穩(wěn)定，簡單易用，高性價比的企業(yè)郵箱，按需自由定制，不限空間，極速收發(fā)，能夠滿足用戶對企業(yè)郵箱的不同需求。可以通過以下幾種方式注冊、申請、購買、試用、開通企業(yè)郵箱：
1、登錄http://www.bingfeng168.cn/services/mail/在線咨詢申請試用或購買；
2、直接致電028-62778877申請試用或正式購買開通；