【文件属性】:
文件名称:使用队列-金蝶云·苍穹混合云部署手册_v1.0
文件大小:2.37MB
文件格式:PDF
更新时间:2021-06-24 04:26:28
FreeRTOS 内核 MCU IOT 嵌入式
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 值表示队列创建成功。此返回值应当保存下来,以作为
操作此队列的句柄。