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

対象タスクが生成されていない