can_act

ican_act

概要

起動要求のキューイング解除

C言語形式

ER_UINT can_act ( ID tskid ); ER_UINT ican_act ( ID tskid );

パラメータ

I/O	パラメータ	説明
I	ID tskid;	タスクのID TSK_SELF： 自タスク 数値： タスクのID

機能

tskidで指定されたタスクにキューイングされている起動要求をすべて解除（起動要求カウンタに0x0を設定）します。

なお，正常終了時は戻り値として本サービス・コールの発行により解除した起動要求数を返します。

備考 本サービス・コールでは，状態操作処理は行わず，起動要求カウンタの設定処理のみを行います。
したがって，READY状態などからDORMANT状態に遷移することはありません。

戻り値

マクロ	数値	意味
E_ID	-18	IDの指定が不正である - tskid＜0x0 - tskid＞生成されているタスクの最大ID - 非タスクから本サービス・コールを発行した際，tskidにTSK_SELFを指定した
E_CTX	-25	CPUロック状態から本サービス・コールを発行した
E_NOEXS	-42	対象タスクが生成されていない
−	正の値	正常終了（解除した起動要求数）