Microchip® Advanced Software Framework

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
xQueueCreate

queue.

h

 xQueueHandle xQueueCreate(
                              unsigned portBASE_TYPE uxQueueLength,
                              unsigned portBASE_TYPE uxItemSize
                          );
   

Creates a new queue instance. This allocates the storage required by the new queue and returns a handle for the queue.

Parameters
uxQueueLengthThe maximum number of items that the queue can contain.
uxItemSizeThe number of bytes each item in the queue will require. Items are queued by copy, not by reference, so this is the number of bytes that will be copied for each posted item. Each item on the queue must be the same size.
Returns
If the queue is successfully create then a handle to the newly created queue is returned. If the queue cannot be created then 0 is returned.

Example usage:

 struct AMessage
 {
    char ucMessageID;
    char ucData[ 20 ];
 };
 void vATask( void *pvParameters )
 {
 xQueueHandle xQueue1, xQueue2;
Create a queue capable of containing 10 unsigned long values.
    xQueue1 = xQueueCreate( 10, sizeof( unsigned long ) );
    if( xQueue1 == 0 )
    {
Queue was not created and must not be used.
    }
Create a queue capable of containing 10 pointers to AMessage structures.
These should be passed by pointer as they contain a lot of data.
    xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
    if( xQueue2 == 0 )
    {
Queue was not created and must not be used.
    }
... Rest of task code.
 }
 

h

 QueueHandle_t xQueueCreate(
                              UBaseType_t uxQueueLength,
                              UBaseType_t uxItemSize
                          );
   

Creates a new queue instance. This allocates the storage required by the new queue and returns a handle for the queue.

Parameters
uxQueueLengthThe maximum number of items that the queue can contain.
uxItemSizeThe number of bytes each item in the queue will require. Items are queued by copy, not by reference, so this is the number of bytes that will be copied for each posted item. Each item on the queue must be the same size.
Returns
If the queue is successfully create then a handle to the newly created queue is returned. If the queue cannot be created then 0 is returned.

Example usage:

 struct AMessage
 {
    char ucMessageID;
    char ucData[ 20 ];
 };
 void vATask( void *pvParameters )
 {
 QueueHandle_t xQueue1, xQueue2;
Create a queue capable of containing 10 uint32_t values.
    xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
    if( xQueue1 == 0 )
    {
Queue was not created and must not be used.
    }
Create a queue capable of containing 10 pointers to AMessage structures.
These should be passed by pointer as they contain a lot of data.
    xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
    if( xQueue2 == 0 )
    {
Queue was not created and must not be used.
    }
... Rest of task code.
 }
 

h

 QueueHandle_t xQueueCreate(
                              UBaseType_t uxQueueLength,
                              UBaseType_t uxItemSize
                          );
   

Creates a new queue instance, and returns a handle by which the new queue can be referenced.

Internally, within the FreeRTOS implementation, queues use two blocks of memory. The first block is used to hold the queue's data structures. The second block is used to hold items placed into the queue. If a queue is created using xQueueCreate() then both blocks of memory are automatically dynamically allocated inside the xQueueCreate() function. (see http://www.freertos.org/a00111.html). If a queue is created using xQueueCreateStatic() then the application writer must provide the memory that will get used by the queue. xQueueCreateStatic() therefore allows a queue to be created without using any dynamic memory allocation.

http://www.FreeRTOS.org/Embedded-RTOS-Queues.html

Parameters
uxQueueLengthThe maximum number of items that the queue can contain.
uxItemSizeThe number of bytes each item in the queue will require. Items are queued by copy, not by reference, so this is the number of bytes that will be copied for each posted item. Each item on the queue must be the same size.
Returns
If the queue is successfully create then a handle to the newly created queue is returned. If the queue cannot be created then 0 is returned.

Example usage:

 struct AMessage
 {
    char ucMessageID;
    char ucData[ 20 ];
 };
 void vATask( void *pvParameters )
 {
 QueueHandle_t xQueue1, xQueue2;
Create a queue capable of containing 10 uint32_t values.
    xQueue1 = xQueueCreate( 10, sizeof( uint32_t ) );
    if( xQueue1 == 0 )
    {
Queue was not created and must not be used.
    }
Create a queue capable of containing 10 pointers to AMessage structures.
These should be passed by pointer as they contain a lot of data.
    xQueue2 = xQueueCreate( 10, sizeof( struct AMessage * ) );
    if( xQueue2 == 0 )
    {
Queue was not created and must not be used.
    }
... Rest of task code.
 }