vTaskPrioritySet
task. More...
task.
h
void vTaskPrioritySet( TaskHandle_t xTask, UBaseType_t uxNewPriority );
INCLUDE_vTaskPrioritySet must be defined as 1 for this function to be available. See the configuration section for more information.
Set the priority of any task.
A context switch will occur before the function returns if the priority being set is higher than the currently executing task.
- Parameters
-
xTask Handle to the task for which the priority is being set. Passing a NULL handle results in the priority of the calling task being set. uxNewPriority The priority to which the task will be set.
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 raise the priority of the created task. vTaskPrioritySet( xHandle, tskIDLE_PRIORITY + 1 ); // ... // Use a NULL handle to raise our priority to the same value. vTaskPrioritySet( NULL, tskIDLE_PRIORITY + 1 );}