原创 消息量函数分析OS_EVENT *OSSemCreate (INT16U cnt)

OS_EVENT  *OSSemCreate (INT16U cnt)                                ；该函数返回的数据类型为指针，指针指向的数据类型为OS_EVENT（事件的数据类型为结构体）。也就是函数返回一个地址，地址里存的是新创建的结构体类型所占据的内存的首地址。 

 OS_EVENT  *pevent;
 pevent = OSEventFreeList;                                                                                                                                                       if (OSEventFreeList != (OS_EVENT *)0) {                /* See if pool of free ECB pool was empty   */
        OSEventFreeList = (OS_EVENT *)OSEventFreeList->OSEventPtr;
    }                           

；首先创建一个指向OS_EVENT结构体类型的指针pevent；系统初始化时会创建一个空事件控制块链表，而创建的空事件控制块的数目由常数OSEventMax来决定。OSEventFreeList就指向这个空事件控制块链表的第一个，所以上面的程序里把OSEventFreeList赋给了pevent，也就是让pevent指向第一个空事件控制块，然后又让OSEventFreeList指向了空事件控制链表中的第二个。也就是从空事件链表中摘出了第一个给事件使用。

 if (pevent != (OS_EVENT *)0) {                         /* Get an event control block               */
        pevent->OSEventType    = OS_EVENT_TYPE_SEM;
        pevent->OSEventCnt     = cnt;                      /* Set semaphore value                      */
        pevent->OSEventPtr     = (void *)0;                /* Unlink from ECB free list                */
#if OS_EVENT_NAME_SIZE > 1
        pevent->OSEventName[0] = '?';                      /* Unknown name                             */
        pevent->OSEventName[1] = OS_ASCII_NUL;
#endif
；以上就是对新创建的空任务控制块的各个量进行初始化。

OS_EventWaitListInit(pevent);           ；通过调用OSEventWaitListInit()对事件控制块中的等待任务列表进行初始化。该函数初始化一个空的等待任务列表，其中没有任何任务。该函数的调用参数只有一个，就是指向需要初始化的事件控制块的指针pevent。         

return (pevent);                                      ；返回创建的结构体类型数据的首地址的指针