FreeRTOS学习 -- 6、任务状态或信息查询API函数

1、任务相关API函数预览

2、任务相关API函数详解

2.1 uxTaskPriorityGet() -- 指定任务优先级函数

        要使用此函数的话宏INCLUDE_uxTaskPriorityGet 应该定义为1；

        函数原型：

UBaseType_t uxTaskPriorityGet(TaskHandle_t xTask);

        参数：xTask：要查找任务的任务句柄；

        返回值：UBaseType_t：获取到的对应任务的优先级。

2.2 vTaskPrioritySet() -- 改变任务的任务优先级函数

        要使用此函数的话宏INCLUDE_vTaskPrioritySet  应该定义为1；

        函数原型：

void vTaskPrioritySet( TaskHandle_t xTask , UBaseType_t uxNewPriority )

        参数：xTask：要查找任务的任务句柄；

                   uxNewPriority：任务要使用的新的优先级。

2.3 uxTaskGetSystemState() -- 获取所有任务状态信息函数

        要使用此函数的话宏configUSE_TRACE_FACILITY 应该定义为1；

        函数原型：

UBaseType_t  uxTaskGetSystemState(   TaskStatus_t * const pxTaskStatusArray,
                                      				const UBaseType_t uxArraySize,
                                      				configRUN_TIME_COUNTER_TYPE * const  pulTotalRunTime  )

        参数：pxTaskStatusArray：指向TaskStatus_t 结构体数组首地址,每个任务至少需要一个                    TaskStatus_t结构体，任务的数量可以使用函数uxTaskGetNumberOfTasks()。
                   uxArraySize：接收信息的数组大小
                   pulTotalRunTime：系统总运行时间，为NULL 则省略总运行时间值

         返回值：统计到任务状态的个数。

2.4 vTaskGetInfo() -- 获取单个任务状态函数

        函数原型：

void vTaskGetInfo( TaskHandle_t xTask, 
				   TaskStatus_t * pxTaskStatus, 
				   BaseType_t xGetFreeStackSpace, 
				   eTaskState eState )