队列管理
[API]

模块

• xQueueCreate
• xQueueCreateStatic
• vQueueDelete
• xQueueSend
• xQueueSendFromISR
• xQueueSendToBack
• xQueueSendToBackFromISR
• xQueueSendToFront
• xQueueSendToFrontFromISR
• xQueueReceive
• xQueueReceiveFromISR
• uxQueueMessagesWaiting
• uxQueueMessagesWaitingFromISR
• uxQueueSpacesAvailable
• xQueueReset
• xQueuePeek
• xQueuePeekFromISR
• vQueueAddToRegistry
• pcQueueGetName
• vQueueUnregisterQueue
• xQueueIsQueueEmptyFromISR
• xQueueIsQueueFullFromISR
• xQueueOverwrite
• xQueueOverwriteFromISR
• xQueueGetStaticBuffers

详细描述

uxQueueMessagesWaiting

UBaseType_t uxQueueMessagesWaiting( QueueHandle_t xQueue );

返回队列中存储的消息数。

参数：

xQueue

正在查询的队列的句柄。

返回：

队列中可用的消息数。

uxQueueMessagesWaitingFromISR

UBaseType_t uxQueueMessagesWaitingFromISR( QueueHandle_t xQueue );

可从 ISR 中调用的 uxQueueMessagesWaiting() 的一个版本。 返回 队列中存储的消息数。

参数：

xQueue

正在查询的队列的句柄。

返回：

队列中可用的消息数。

uxQueueSpacesAvailable

UBaseType_t uxQueueSpacesAvailable( QueueHandle_t xQueue );

返回队列中的可用空间数。

参数：

xQueue

正在查询的队列的句柄。

返回：

队列中可用的可用空间数。

vQueueDelete

void vQueueDelete( QueueHandle_t xQueue );

删除队列 — 释放分配用于存储放置在队列中的项目的所有内存。

参数：

xQueue

要删除的队列的句柄。

xQueueReset

BaseType_t xQueueReset( QueueHandle_t xQueue );

将队列重置为其原始的空状态。

参数：

xQueue

正在重置的队列的句柄

返回：

因为 FreeRTOSV7.2.0 xQueueReset() 总是返回 pdPASS。

xQueueIsQueueEmptyFromISR

BaseType_t xQueueIsQueueEmptyFromISR( const QueueHandle_t xQueue );

查询队列以确定队列是否为空。 此函数只能用于 ISR。

参数：

xQueue

正在查询的队列的句柄

返回：

如果队列不为空，则返回 pdFALSE；如果队列为空，则返回 pdTRUE。

xQueueIsQueueFullFromISR

BaseType_t xQueueIsQueueFullFromISR( const QueueHandle_t xQueue );

查询队列以确定队列是否已满。 此函数只能用于 ISR。

参数：

xQueue

正在查询的队列的句柄

返回：

如果队列未满，则返回 pdFALSE；如果队列已满，则返回 pdTRUE。