04_FreeRTOS任务信息常用API

0. 前言

任务信息相关API的作用：

• 主要对任务的优先级、数量、状态等信息进行配置与查询。

1. 任务相关常见API

常用API列表：

1. uxTaskPriorityGet()：获取任务优先级
2. vTaskPrioritySet()：设置任务优先级
3. uxTaskGetNumberOfTasks()：获取系统中任务的数量
4. uxTaskGetSystemState()：获取所有任务状态信息
5. vTaskGetInfo()：获取指定单个的任务信息
6. xTaskGetCurrentTaskHandle()：获取当前任务的任务句柄
7. xTaskGetHandle()：根据任务名获取该任务的任务句柄
8. uxTaskGetStackHighWaterMark()：获取任务的任务栈历史剩余最小值
9. eTaskGetState()：获取任务状态
10. vTaskList()：以“表格”形式获取所有任务的信息

2. 任务相关API示例

1. uxTaskPriorityGet示例

函数说明： 获取任务的优先级

• 注意实现：INCLUDE_uxTaskPriorityGet定义为1
• 参数1：任务句柄
  • 任务句柄本质上就是任务的控制块，用于存放任务相关配置与信息
• 返回值：函数优先级

UBaseType_t uxTaskPriorityGet( const TaskHandle_t xTask );

2. vTaskPrioritySet示例

函数说明： 设置任务的优先级

• 注意实现：INCLUDE_vTaskPrioritySet定义为1
• 参数1：任务句柄
  • 任务句柄本质上就是任务的控制块，用于存放任务相关配置与信息
• 参数2：任务优先级

void vTaskPrioritySet( TaskHandle_t xTask,
                       UBaseType_t uxNewPriority );

3. uxTaskGetNumberOfTasks示例

函数说明： 获取任务数量

• 返回值：任务数量

UBaseType_t uxTaskGetNumberOfTasks( void );

4. uxTaskGetSystemState示例

函数说明