Everything

ref_tsk

iref_tsk

概要
タスク詳細情報の参照
C言語形式
 ER      ref_tsk ( ID tskid, T_RTSK *pk_rtsk );
 ER      iref_tsk ( ID tskid, T_RTSK *pk_rtsk );

パラメータ
I/O
パラメータ
説明
I
 ID      tskid;
タスクのID
TSK_SELF: 自タスク
数値: タスクのID
O
 T_RTSK  *pk_rtsk;
タスク詳細情報を格納する領域へのポインタ

【 タスク詳細情報T_RTSKの構造 】
 typedef struct  t_rtsk {
         STAT    tskstat;        /*現在状態*/
         PRI     tskpri;         /*現在優先度*/
         PRI     tskbpri;        /*システム予約領域*/
         STAT    tskwait;        /*待ち要因*/
         ID      wobjid;         /*管理オブジェクトのID*/
         UH      RFU1;           /*システム予約領域*/
         TMO     lefttmo;        /*残り時間*/
         UINT    actcnt;         /*起動要求数*/
         UINT    wupcnt;         /*起床要求数*/
         UINT    suscnt;         /*サスペンド要求数*/
         ATR     tskatr;         /*属性*/
         PRI     itskpri;        /*初期優先度*/
         ID      memid;          /*システム予約領域*/
 } T_RTSK;

機能
tskidで指定されたタスクのタスク詳細情報(現在状態,現在優先度など)をpk_rtskで指定された領域に格納します。
備考 タスク詳細情報T_RTSKについての詳細は,「15.2.1 タスク詳細情報」を参照してください。
戻り値
マクロ
数値
意味
E_OK
0
正常終了
E_ID
-18
IDの指定が不正である
- tskid<0x0
- tskid>生成されているタスクの最大ID
- 非タスクから本サービス・コールを発行した際,tskidにTSK_SELFを指定した
E_CTX
-25
CPUロック状態から本サービス・コールを発行した
E_NOEXS
-42
対象タスクが生成されていない