chg_pri

ichg_pri

概要

タスク優先度の変更

C言語形式

ER chg_pri ( ID tskid, PRI tskpri ); ER ichg_pri ( ID tskid, PRI tskpri )

パラメータ

I/O	パラメータ	説明
I	ID tskid;	タスクのID TSK_SELF： 自タスク 数値： タスクのID
I	PRI tskpri;	タスクの優先度 TPRI_INI： タスクの初期優先度 数値： タスクの優先度

機能

tskidで指定されたタスクの優先度（現在優先度）をtskpriで指定された値に変更します。

対象タスクがRUNNING状態，またはREADY状態であった場合には，優先度を変更したのち，対象タスクをtskpriで指定された優先度に応じたレディ・キューの最後尾につなぎかえます。

備考 対象タスクが何らかの待ちキューに優先度順でキューイングされていた場合，本サービス・コールの発行により，待ち順序が変わることがあります。

例 セマフォの待ちキューに3つのタスク（タスクA：優先度10，タスクB：優先度11，タスクC：優先度12）が優先度順でキューイングされているとき，タスクBの優先度を11から9に変更した場合，待ちキューの待ち順序は，以下のように変更されます。

　

戻り値

マクロ	数値	意味
E_OK	0	正常終了
E_PAR	-17	優先度の指定が不正である - tskpri＜0x0 - tskpri＞最大タスク優先度
E_ID	-18	IDの指定が不正である - tskid＜0x0 - tskid＞生成されているタスクの最大ID - 非タスクから本サービス・コールを発行した際，tskidにTSK_SELFを指定した
E_CTX	-25	CPUロック状態から本サービス・コールを発行した
E_OBJ	-41	対象タスクがDORMANT状態である
E_NOEXS	-42	対象タスクが生成されていない