rel_wai

irel_wai

概要

WAITING状態の強制解除

C言語形式

 ER      rel_wai ( ID tskid );
 ER      irel_wai ( ID tskid );
パラメータ

I/O

パラメータ

説明

I

 ID      tskid;
タスクのID



機能

tskidで指定されたタスクのWAITING状態を強制的に解除します。これにより,対象タスクは待ちキューから外れ,WAITING状態からREADY状態へ,またはWAITING-SUSPENDED状態からSUSPENDED状態へと遷移します。

なお,本サービス・コールの発行によりWAITING状態を解除されたタスクには,WAITING状態へと遷移するきっかけとなったサービス・コール(slp_tskwai_semなど)の戻り値としてE_RLWAIを返します。

備考1 本サービス・コールでは,解除要求のキューイングが行われません。このため,対象タスクがWAITING状態でもWAITING-SUSPENDED状態でもない場合には,戻り値としてE_OBJを返します。

備考2 本サービス・コールでは,SUSPENDED状態の解除は行われません。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_ID

-18

不正ID番号

- tskid≦0

- tskid > VTMAX_TSK

E_CTX

-25

コンテキスト・エラー

- CPUロック状態から本サービス・コールを発行した。

- タスクからirel_waiを発行した。

- 非タスクからrel_waiを発行した。

- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。

E_MACV

-26

メモリ・アクセス違反(rel_waiのみ)

- スタック・ポインタが呼出しタスクのユーザ・スタック領域の範囲外を指している。

E_OBJ

-41

オブジェクト状態エラー

- 対象タスクが,WAITING状態でもWAITING-SUSPENDED状態でもない。

E_NOEXS

-42

オブジェクト未生成

- tskidのタスクが存在しない。