FreeRTOS中uxQueueMessagesWaiting函数的理解

浏览了网上所有uxQueueMessagesWaiting的说明，基本上就是一句话： uxQueueMessagesWaiting() 被用来查询 queue 现在包含的数据项数。并没有深入的说明该API的一些具体实现方式，而深入研究该API的详细代码，感觉看不懂，或者看懂需要花费大量时间，本人水平一般，因此采取实践法来理解这个API，通过对改函数做多次具体实验，得出了以下结论：
在UART中断接收的情况下，使用该API返回的是队列中的接收个数，这个不是接收完才返回，实际项目中是一边接收一边返回，比如接收队列创建的长度是16，用串口助手一次性发送多于16个字节的长度，比如一次性发送20个字节，正常来说20个字节已经是超出队列长度了，必然报错，然而实验结果是发送几次后才报错，是哪一次报错不定，也可能出现在第一次。

	if (uxQueueMessagesWaiting(pUartIntrObj->xRxQueue)) //判断队列中是否有数据
	{
		if (timeout_val)
			lasttime = itpGetTickCount();
		while (count < len) 
		{
			if (xQueueReceive(pUartIntrObj->xRxQueue, ptr, 0)) //该API一次只接收一个数据到ptr中，档接收完len长度的数据后返回，或者超时返回
			{
				count++;
				ptr++;
				continue;
			}
			else if (timeout_val)
			{
				if (itpGetTickDuration(lasttime) < timeout_val)
					usleep(1);
				else
					ithPrintf("rxqueue1 is ok %d\n",count);
					break;
			}
			else
				ithPrintf("rxqueue2 is ok %d\n",count);
				break;
			ithPrintf("rxqueue3 is ok %d\n",count);
		}
	}
	
	
	if (pUartIntrObj->RxQueueFull)
		ithPrintf("rxqueue is Full %d\n",len);
	return count;

必须注意的是xQueueReceive函数吧接收的数据COPE到ptr后，会删除掉队列中的对应个数的数据。
由此，发送20个数据，当uxQueueMessagesWaiting返回后，可能队列中当时只接收到<16个的数据，被xQueueReceive读取后，队列为空，然后再接收剩下的数据，如果第一次返回的数据<4个，第二次再返回时队列是满的，那就会报溢出。

如果所有返回都没有超过最大队列16个数据，就不会报错。只要出现返回时队列中>=16的数据，就报错。