開発ツール

ref_tst

概要

タスク基本情報の参照

C言語形式

 ER      ref_tst ( ID tskid, T_RTST *pk_rtst );

 ER      iref_tst ( ID tskid, T_RTST *pk_rtst );

パラメータ


I/O	パラメータ	説明
I	ID tskid;	タスクのID TSK_SELF：自タスク数値：タスクのID
O	T_RTST *pk_rtst;	タスク基本情報を格納する領域へのポインタ

【タスク基本情報T_RTSTの構造】


typedef struct t_rtst { STAT tskstat; /現在状態/ STAT tskwait; /待ち要因/ } T_RTST;

機能

tskidで指定されたタスクのタスク基本情報（現在状態，待ち要因）をpk_rtstで指定された領域に格納します。

タスク情報のうち，現在状態，待ち要因のみを参照したい場合に使用します。

取得する情報が少ないのでref_tsk，iref_tskより高速に応答します。

- tskstat
タスクの現在状態が格納されます。

TTS_RUN： RUNNING状態

TTS_RDY： READY状態

TTS_WAI： WAITING状態

TTS_SUS： SUSPENDED状態

TTS_WAS： WAITING-SUSPENDED状態

TTS_DMT： DORMANT状態

- tskwait
タスクの待ち要因（WAITING状態の種類）が格納されます。
tskwaitは，tskstatがTTS_WAIまたはTTS_WASの場合のみ有効です。

TTW_SLP： slp_tskまたはtslp_tskによる起床待ち状態

TTW_DLY： dly_tskによる時間経過待ち状態

TTW_SEM： wai_semまたはtwai_semによる資源獲得待ち状態

TTW_FLG： wai_flgまたはtwai_flgによるイベントフラグ待ち状態

TTW_SDTQ： snd_dtqまたはtsnd_dtqによるデータ送信待ち状態

TTW_RDTQ： rcv_dtqまたはtrcv_dtqによるデータ受信待ち状態

TTW_MBX： rcv_mbxまたはtrcv_mbxによるメッセージ受信待ち状態

TTW_MTX： loc_mtxまたはtloc_mtxによるミューテックス待ち状態

TTW_SMBF： snd_mbfまたはtsnd_mbfによるメッセージ送信待ち状態

TTW_RMBF： rcv_mbfまたはtrcv_mbfによるメッセージ受信待ち状態

TTW_MPF： get_mpfまたはtget_mpfによる固定長メモリ・ブロック獲得待ち状態

TTW_MPL： get_mplまたはtget_mplによる可変長メモリ・ブロック獲得待ち状態

戻り値


マクロ	数値	意味
E_OK	0	正常終了
E_ID	-18	不正ID番号 - tskid＜0 - tskid＞VTMAX_TSK - 非タスクから本サービス・コールを発行した際，tskidにTSK_SELFを指定した。
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。備考タスクからiref_tstを発行した場合，および非タスクからref_tstを発行した場合，コンテキスト・エラーは検出されず，システムの正常な動作は保証されません。