vQueueUnregisterQueue
[队列管理]
queue.h
void vQueueUnregisterQueue(
QueueHandle_t xQueue,
);
从队列注册表中删除队列。
- 参数:
-
队列注册表有两个目的,都与 RTOS 内核感知调试相关:
- 可以关联文本名称和队列,便于在调试 GUI 中识别队列。
- 包含调试器定位每个已注册队列和信号量所需的信息。
除非使用 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" );
/* The queue gets used here. */
/* At some later time, the queue is going to be deleted, first
remove it from the registry. */
vQueueUnregisterQueue( xQueue );
vQueueDelete( xQueue );
}
Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.
|