Microchip® Advanced Software Framework

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

task.

h

unsigned portBASE_TYPE uxTaskPriorityGet( xTaskHandle xTask );

INCLUDE_xTaskPriorityGet must be defined as 1 for this function to be available. See the configuration section for more information.

Obtain the priority of any task.

Parameters
xTaskHandle of the task to be queried. Passing a NULL handle results in the priority of the calling task being returned.
Returns
The priority of xTask.

Example usage:

 void vAFunction( void )
 {
 xTaskHandle xHandle;
Create a task, storing the handle.
     xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
...
Use the handle to obtain the priority of the created task.
It was created with tskIDLE_PRIORITY, but may have changed
it itself.
     if( uxTaskPriorityGet( xHandle ) != tskIDLE_PRIORITY )
     {
The task has changed it's priority.
     }
...
Is our priority higher than the created task?
     if( uxTaskPriorityGet( xHandle ) < uxTaskPriorityGet( NULL ) )
     {
Our priority (obtained using NULL handle) is higher.
     }
 }
   

h

unsigned portBASE_TYPE uxTaskPriorityGet( xTaskHandle pxTask );

INCLUDE_xTaskPriorityGet must be defined as 1 for this function to be available. See the configuration section for more information.

Obtain the priority of any task.

Parameters
pxTaskHandle of the task to be queried. Passing a NULL handle results in the priority of the calling task being returned.
Returns
The priority of pxTask.

Example usage:

 void vAFunction( void )
 {
 xTaskHandle xHandle;
Create a task, storing the handle.
     xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
...
Use the handle to obtain the priority of the created task.
It was created with tskIDLE_PRIORITY, but may have changed
it itself.
     if( uxTaskPriorityGet( xHandle ) != tskIDLE_PRIORITY )
     {
The task has changed it's priority.
     }
...
Is our priority higher than the created task?
     if( uxTaskPriorityGet( xHandle ) < uxTaskPriorityGet( NULL ) )
     {
Our priority (obtained using NULL handle) is higher.
     }
 }
   

h

UBaseType_t uxTaskPriorityGet( TaskHandle_t xTask );

INCLUDE_uxTaskPriorityGet must be defined as 1 for this function to be available. See the configuration section for more information.

Obtain the priority of any task.

Parameters
xTaskHandle of the task to be queried. Passing a NULL handle results in the priority of the calling task being returned.
Returns
The priority of xTask.

Example usage:

 void vAFunction( void )
 {
 TaskHandle_t xHandle;
Create a task, storing the handle.
     xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );
...
Use the handle to obtain the priority of the created task.
It was created with tskIDLE_PRIORITY, but may have changed
it itself.
     if( uxTaskPriorityGet( xHandle ) != tskIDLE_PRIORITY )
     {
The task has changed it's priority.
     }
...
Is our priority higher than the created task?
     if( uxTaskPriorityGet( xHandle ) < uxTaskPriorityGet( NULL ) )
     {
Our priority (obtained using NULL handle) is higher.
     }
 }