UCOS3信号量删除函数解析

/*
************************************************************************************************************************
*                                                  DELETE A SEMAPHORE
*
* Description: This function deletes a semaphore.
*
* Arguments  : p_sem         指向要删除的信号量的指针
*
*              opt           指定删除信号量的条件:
*
*                                OS_OPT_DEL_NO_PEND          只有当没有任何任务在等待这个信号量时才删除信号量，虽然当前没有任务
在等待这个信号量，但这不意味着以后不会有任务等待这个信号量，任务必须能够处理
“等待被删除的信号量”的异常情况
*                                OS_OPT_DEL_ALWAYS           不管是否有任务在等待这个信号量，都删除这个信号量.这种情况下，所有等待该
信号量的任务都被置为就绪。这些任务知道其被置为就绪的原因是其等待的信号量已经被
删除了，这些任务也需要能处理“等待被删除的信号量”的情况。
*                       
*
*              p_err         指向一个变量，用来存放该函数返回的错误码.
*
*                                OS_ERR_NONE                 成功删除信号量
*                                OS_ERR_DEL_ISR              OS_CFG_CALLED_FROM_ISR_CHK_EN被设置为1，
     但代码尝试从中断服务程序中删除一个信号量
*                                OS_ERR_OBJ_PTR_NULL         OS_CFG_ARG_CHK_EN被设置为1，但p_sem指针为空.
*                                OS_ERR_OBJ_TYPE             OS_CFG_OBJ_TYPE_CHK_EN设置为1，但p_sem没有指向信号量。
*                                OS_ERR_OPT_INVALID          OS_CFG_ARGE_CHK_EN被设置为1，
     但是opt参数并不是两个允许的指定参数值
*                                OS_ERR_TASK_WAITING         有一个或者多个任务等待这个信号量
*
* Returns    : == 0          if no tasks were waiting on the semaphore, or upon error.

*              >  0          if one or more tasks waiting on the semaphore are now readied and informed.
*
* Note(s)    : 1) This function must be used with care.  Tasks that would normally expect the presence of the semaphore
*                 MUST check the return code of OSSemPend().
*              2) OSSemAccept() callers will not know that the intended semaphore has been deleted.
*              3) Because ALL tasks pending on the semaphore will be readied, you MUST be careful in applications where
*                 the semaphore is used for mutual exclusion because the resource(s) will no longer be guarded by the
*                 semaphore.
************************************************************************************************************************
*/

#if OS_CFG_SEM_DEL_EN > 0u          //允许删除使能
OS_OBJ_QTY  OSSemDel (OS_SEM  *p_sem,     //指向要删除的信号量的指针
                      OS_OPT   opt, //指定删除信号量的条件
                      OS_ERR  *p_err) //指向一个变量，用来存放该函数返回的错误码
{
    OS_OBJ_QTY     cnt; //删除表中删除的数量
    OS_OBJ_QTY     nbr_tasks;
    OS_PEND_DATA  *p_pend_data; //指向等待的数据
    OS_PEND_LIST  *p_pend_list; //指向等待任务列表
    OS_TCB        *p_tcb;
    CPU_TS         ts;
    CPU_SR_ALLOC();

#ifdef OS_SAFETY_CRITICAL //安全监测
    if (p_err == (OS_ERR *)0) {
        OS_SAFETY_CRITICAL_EXCEPTION();
        return ((OS_OBJ_QTY)0);
    }
#endif