get_tid

iget_tid

概要

RUNNING状態のタスクの参照

C言語形式

 ER      get_tid ( ID *p_tskid );

 ER      iget_tid ( ID *p_tskid );

パラメータ

I/O	パラメータ	説明
O	ID *p_tskid;	タスクIDを格納する領域へのポインタ

機能

RUNNING状態のタスクのIDをp_tskidで指定された領域に格納します。

RUNNING状態のタスクが存在しない場合（IDLE状態）には，p_tskidで指定された領域にTSK_NONEを格納します。

戻り値

マクロ	数値	意味
E_OK	0	正常終了
E_PAR	-17	パラメータ・エラー - p_tskid == NULL
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。 備考 タスクからiget_tidを発行した場合，および非タスクからget_tidを発行した場合，コンテキスト・エラーは検出されず，システムの正常な動作は保証されません。
E_MACV	-26	メモリ・アクセス違反（get_tidのみ） - 呼び出しタスクからのp_tskidが示す領域に対するオペランド・ライト・アクセス許可がない。