1. 程式人生 > >任務相關的API函數-uxTaskGetSystemState

任務相關的API函數-uxTaskGetSystemState

arrays long 枚舉類 應該 時間 ntp 第一步 優先 api函數

uxTaskGetSystemState:此函數用於獲取系統中所有的任務狀態,每個任務的狀態信息保存在一個TaskStatus_t類型的結構體裏面.要使用此函數必須把 configUSE_TRACE_FACILITY 打開,在FreeRtos.h文件的744行(V9.0)

返回值:統計到任務狀態的個數,也就是填寫到數組pxTaskStatusArray中的個數,此值應該等於函數uxTaskGetNumberOfTask()的返回值,如果uxArraySize太小的話返回值可能為0

UBaseType_t uxTaskGetSystemState( TaskStatus_t * const pxTaskStatusArray,

const UBaseType_t uxArraySize,

uint32_t * const pulTotalRunTime )

typedef struct xTASK_STATUS
{
TaskHandle_t xHandle;//任務句柄
const char *pcTaskName;//任務名字
UBaseType_t xTaskNumber;//任務編號 typedef unsigned long UBaseType_t;
eTaskState eCurrentState;//當前任務狀態,eTaskState是一個枚舉類型
UBaseType_t uxCurrentPriority;//任務當前的優先級
UBaseType_t uxBasePriority;//任務基礎優先級
uint32_t ulRunTimeCounter;//任務運行的總時間
StackType_t *pxStackBase;//堆棧基地址
uint16_t usStackHighWaterMark;//從任務創建以來任務堆棧剩余的最小大小,此值如果太小的話說//明堆棧有溢出的風險
} TaskStatus_t;

u32 TotalRunTime;
UBaseType_t ArraySize,x;
TaskStatus_t *StatusArray;
//第一步:函數uxTaskGetSystemState()的使用
printf("/*********第一步:函數函數uxTaskGetSystemState()的使用*****/\r\n");
ArraySize=uxTaskGetNumberOfTasks();//獲取系統任務數量
StatusArray=pvPortMalloc(ArraySize*sizeof(TaskStatus_t));//申請內存
if(StatusArray!=NULL) //內存申請成功
{
ArraySize=uxTaskGetSystemState((TaskStatus_t* )StatusArray,
(UBaseType_t)ArraySize,
(uint32_t*)&TotalRunTime);
printf("TaskName\t\tPriority\t\tTaskNumber\t\t\r\n");
for(x=0;x<ArraySize;x++)
{
//通過串口打印出獲取到的系統的有關信息 比如任務名稱,
//任務優先級和任務編號
printf("%s\t\t%d\t\t\t%d\t\t\t\r\n",
StatusArray[x].pcTaskName,
(int)StatusArray[x].uxCurrentPriority,
(int)StatusArray[x].xTaskNumber);
}

}
vPortFree(StatusArray); //釋放內存

任務相關的API函數-uxTaskGetSystemState