Download FreeRTOS

Quality RTOS & Embedded Software

FreeRTOS website now available in Simplified Chinese
New FreeRTOS Long Term Support version now available.
FreeRTOS Extended Maintenance Program (EMP) registration now open.
FreeRTOS-Plus-TCP v3.0.0 released:
Featured FreeRTOS IoT Integrations:

[Queue Management]

void vQueueUnregisterQueue( QueueHandle_t xQueue, );

Removes a queue from the queue registry.

xQueue The handle of the queue being removed from the registry.
The queue registry has two purposes, both of which are associated with RTOS kernel aware debugging:
  1. It allows a textual name to be associated with a queue for easy queue identification within a debugging GUI.
  2. It contains the information required by a debugger to locate each registered queue and semaphore.
The queue registry has no purpose unless you are using a RTOS kernel aware debugger.

configQUEUE_REGISTRY_SIZE defines the maximum number of queues and semaphores that can be registered. Only the queues and semaphores that you want to view using a RTOS kernel aware debugger need to be registered.


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.