Everything

vrst_mbf

概要
メッセージ・バッファのリセット
C言語形式
 ER      vrst_mbf ( ID mbfid );
パラメータ
I/O
パラメータ
説明
I
 ID      mbfid;
メッセージ・バッファのID

機能
mbfidで指定されたメッセージ・バッファをリセットします。
メッセージ・バッファに蓄えられていたメッセージは破棄されます。また,メッセージ送信を待っていたタスクの待ち状態は解除され,そのタスクには戻り値としてEV_RSTが返されます。
備考1 本サービス・コールでは,メッセージ受信を待っていたタスクの待ち状態は解除されません。
備考2 本サービス・コールはμITRON4.0仕様外の機能です。
戻り値
マクロ
数値
意味
E_OK
0
正常終了
E_ID
-18
不正ID番号
- mbfid≦0
- mbfid > VTMAX_MBF
E_CTX
-25
コンテキスト・エラー
- 非タスクから本サービス・コールを発行した。
- CPUロック状態から本サービス・コールを発行した。
- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。
E_MACV
-26
メモリ・アクセス違反
- スタック・ポインタが呼出しタスクのユーザ・スタック領域の範囲外を指している。
E_NOEXS
-42
オブジェクト未生成
- mbfidのデータ・キューが存在しない。