psnd_mbf

ipsnd_mbf

概要

メッセージの送信（ポーリング）

C言語形式

 ER      psnd_mbf ( ID mbfid, VP　msg, UINT msgsz );

 ER      ipsnd_mbf ( ID mbfid, VP　msg, UINT msgsz );

パラメータ

I/O	パラメータ	説明
I	ID mbfid;	メッセージ・バッファのID
I	VP msg;	送信メッセージへのポインタ
I	UINT msgsz;	送信メッセージのサイズ（単位：バイト）

機能

mbfidで指定されたメッセージ・バッファの状況に応じて，以下の処理を行います。

- 受信待ちキューにタスクがキューイングされている場合
msgで指定されたメッセージを受信待ちキュー先頭のタスクに渡します，これにより，該当タスクは受信待ちキューから外れ，WAITING状態（メッセージ受信待ち状態）からREADY状態へ，またはWAITING-SUSPENDED状態からSUSPENDED状態へと遷移します。

- 受信待ちキューおよび送信待ちキューにタスクがキューイングされておらず，メッセージ・バッファにメッセージを格納するための空き領域がある場合
msgで指定されたメッセージをメッセージ・バッファに格納します。このとき，対象メッセージ・バッファの空き領域は以下の式で算出されるサイズだけ減少します。
　減少サイズ＝up4(msgsz)＋VTSZ_MBFTBL

- 受信待ちキューおよび送信待ちキューにタスクがキューイングされておらず，メッセージ・バッファにメッセージを格納するための空き領域がない場合，または送信待ちキューにタスクがキューイングされている場合
戻り値としてE_TMOUTを返します。

備考 メッセージを対象メッセージ・バッファに書き込む際の書き込み方法は，メッセージの送信要求を行った順に行われます。

戻り値

マクロ	数値	意味
E_OK	0	正常終了
E_PAR	-17	パラメータ・エラー - msgsz == 0 - msgsz > (生成時に指定したメッセージの最大サイズ） - msg == NULL
E_ID	-18	不正ID番号 - mbfid≦0 - mbfid > VTMAX_MBF
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - タスクからipsnd_mbfを発行した。 - 非タスクからpsnd_mbfを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。
E_MACV	-26	メモリ・アクセス違反（psnd_mbfのみ） - スタック・ポインタが呼出しタスクのユーザ・スタック領域の範囲外を指している。 - 呼び出しタスクからのmsgが示す領域（先頭：msg，サイズ：msgsz）に対するオペランド・リード・アクセス許可がない。
E_NOEXS	-42	オブジェクト未生成 - mbfidのメッセージ・バッファが存在しない。
E_TMOUT	-50	ポーリング失敗