開発ツール

get_pri

概要

タスク現在優先度の参照

C言語形式

 ER      get_pri ( ID tskid, PRI *p_tskpri );

 ER      iget_pri ( ID tskid, PRI *p_tskpri );

パラメータ


I/O	パラメータ	説明
I	ID tskid;	タスクのID TSK_SELF：自タスク数値：タスクのID
O	PRI *p_tskpri;	現在優先度を格納する領域へのポインタ

機能

tskidで指定されたタスクの現在優先度をp_tskpriで指定された領域に格納します。

備考現在優先度とベース優先度については，「8.2.2　現在優先度とベース優先度」を参照してください。

戻り値


マクロ	数値	意味
E_OK	0	正常終了
E_PAR	-17	パラメータ・エラー - p_tskpri == NULL
E_ID	-18	不正ID番号 - tskid < 0 - tskid > VTMAX_TSK - 非タスクから本サービス・コールを発行した際，tskidにTSK_SELFを指定した。
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。備考タスクからiget_priを発行した場合，および非タスクからget_priを発行した場合，コンテキスト・エラーは検出されず，システムの正常な動作は保証されません。
E_MACV	-26	メモリ・アクセス違反（get_priのみ） - 呼び出しタスクからのp_tskpriが示す領域に対するオペランド・ライト・アクセス許可がない。
E_OBJ	-41	オブジェクト状態エラー - 対象タスクがDORMANT状態である。
E_NOEXS	-42	オブジェクト未生成 - tskidのタスクが存在しない。