Everything

rot_rdq

irot_rdq

概要
タスクの優先順位の回転
C言語形式
 ER      rot_rdq ( PRI tskpri );
 ER      irot_rdq ( PRI tskpri );
パラメータ
I/O
パラメータ
説明
I
 PRI     tskpri;
タスクの優先度
TPRI_SELF: 自タスクのベース優先度
数値: タスクの優先度

機能
tskpriで指定された優先度に対応したレディ・キューの先頭タスクを最後尾につなぎかえ,タスクの実行順序を明示的に変更します。
備考1 本サービス・コールでは,レディ・キューの対象優先度にタスクが1つもキューイングされていなかった場合,何も処理は行わず,エラーとしても扱いません。
備考2 本サービス・コールを周期ハンドラなどから一定周期で発行することにより,ラウンドロビン・スケジューリングを実現することができます。
備考3 RI600V4におけるレディ・キューは,優先度をキーとしたハッシュ・テーブルであり,実行可能な状態(RUNNING状態またはREADY状態)へと遷移したタスクがFIFO順でキューイングされます。このため,スケジューラは,起動された際にレディ・キューの優先度高位から検出処理を実行し,キューイングされているタスクを検出した場合には,該当優先度の先頭タスクにCPUの利用権を与えることにより,RI600V4のスケジューリング方式(優先度方式,FCFS方式)を実現しています。
備考4 ミューテックスをロック中のタスクの現在優先度は,ベース優先度と異なる場合があります。この場合,そのタスクが本サービス・コールでtskpriTPRI_SELFを指定しても,自タスクが属する現在優先度のレディ・キューを回転することはできません。
備考5 現在優先度とベース優先度については,「6.2.2 現在優先度とベース優先度」を参照してください。
戻り値
マクロ
数値
意味
E_OK
0
正常終了
E_PAR
-17
パラメータ・エラー
- tskpri<0
- tskpriTMAX_TPRI
- irot_rdqを発行した際,tskpriTPRI_SELFを指定した。
E_CTX
-25
コンテキスト・エラー
- CPUロック状態から本サービス・コールを発行した。
- タスクからirot_rdqを発行した。
- 非タスクからrot_rdqを発行した。
- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。