【文件属性】：
文件名称：使用队列-ri5cy_user_manual
文件大小：3.05MB
文件格式：PDF
更新时间：2024-06-23 11:42:23
FreeRTOS 中文
2.3 使用队列
xQueueCreate() API 函数
队列在使用前必须先被创建。
队列由声明为 xQueueHandle 的变量进行引用。xQueueCreate()用于创建一个队
列，并返回一个 xQueueHandle 句柄以便于对其创建的队列进行引用。
当创建队列时，FreeRTOS 从堆空间中分配内存空间。分配的空间用于存储队列数
据结构本身以及队列中包含的数据单元。如果内存堆中没有足够的空间来创建队列，
xQueueCreate()将返回 NULL。第五章会有关于内存堆管理的更多信息。
xQueueHandle xQueueCreate( unsigned portBASE_TYPE uxQueueLength,
unsigned portBASE_TYPE uxItemSize );
程序清单 29 xQueueCreate() API 函数原型
表 7 xQueueCreate()参数与返回值
参数名 描述
uxQueueLength 队列能够存储的 大单元数目，即队列深度。
uxItemSize 队列中数据单元的长度，以字节为单位。
返回值 NULL 表示没有足够的堆空间分配给队列而导致创建失败。
非 NULL 值表示队列创建成功。此返回值应当保存下来，以作为
操作此队列的句柄。