stp_cyc

istp_cyc

概要

周期ハンドラの動作停止

C言語形式

 ER      stp_cyc ( ID cycid );

 ER      istp_cyc ( ID cycid );

パラメータ

I/O	パラメータ	説明
I	ID cycid;	周期ハンドラのID

機能

cycidで指定された周期ハンドラの動作状態を動作状態（STA状態）から停止状態（STP状態）へと遷移させます。これにより，本サービス・コールの発行からsta_cycまたはista_cycが発行されるまでの間，対象周期ハンドラは，RI600PXの起動対象から除外されます。

備考 本サービス・コールでは，停止要求のキューイングが行われません。このため，すでに本サービス・コールが発行され，対象周期ハンドラの動作状態が停止状態（STP状態）へと遷移していた場合には，何も処理は行わず，エラーとしても扱いません。

戻り値

マクロ	数値	意味
E_OK	0	正常終了
E_ID	-18	不正ID番号 - cycid≦0 - cycid > VTMAX_CYH
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。 備考 タスクからistp_cycを発行した場合，および非タスクからstp_cycを発行した場合，コンテキスト・エラーは検出されず，システムの正常な動作は保証されません。
E_NOEXS	-42	オブジェクト未生成 - cycidの周期ハンドラが存在しない。