任務相關的API函數-uxTaskGetSystemState

標籤：mst   結構   unsigned   通過   for   systems   white   枚舉類   pac   

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