下载 FreeRTOS
 

出色的 RTOS & 嵌入式软件

内核
最新资讯
FreeRTOS-Plus-TCP 现具有统一的 IPv4 和 IPv6 功能,支持多接口。
为基于 FreeRTOS 的固件实现防砖化 MCU FOTA:
宣布停止支持 FreeRTOS 202012 LTS。
FreeRTOS 网站现已提供简体中文版本
新的 FreeRTOS Long Term Support 版本现已发布。

vQueueAddToRegistry
[队列管理]

queue.h
void vQueueAddToRegistry( QueueHandle_t xQueue, char *pcQueueName, );

为队列指定名称,并将队列添加到注册表。

参数:
xQueue 添加到注册表的队列句柄。
pcQueueName 指定的队列名称。 此为文本字符串,仅为便于调试之用。队列注册表仅存储指向该字符串的指针,因此该字符串必须具有持久性(全局变量,或最好是在 ROM/Flash 中),而不是在堆栈上定义。
队列注册表有两项用途,都与 RTOS 内核感知调试相关:
  1. 可以关联文本名称和队列,便于在调试 GUI 中识别队列。
  2. 包含调试器定位每个已注册队列和信号量所需的信息。
除非使用 RTOS 内核感知调试器,否则队列注册表没有任何用途。

configQUEUE_REGISTRY_SIZE 定义了可以注册的队列和信号量的最大数量。 仅需注册那些要使用 RTOS 内核感知调试器查看的队列和信号量。

示例:

void vAFunction( void ) { QueueHandle_t xQueue; /* Create a queue big enough to hold 10 chars. */ xQueue = xQueueCreate( 10, sizeof( char ) ); /* We want this queue to be viewable in a RTOS kernel aware debugger, so register it. */ vQueueAddToRegistry( xQueue, "AMeaningfulName" ); }





Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.