文件名称:使用队列-金蝶云·苍穹混合云部署手册_v1.0
文件大小:2.37MB
文件格式:PDF
更新时间:2024-07-13 22:13:08
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 值表示队列创建成功。此返回值应当保存下来,以作为 操作此队列的句柄。