ref_mbf

iref_mbf

概要

メッセージ・バッファ詳細情報の参照

C言語形式

 ER      ref_mbf ( ID mbfid, T_RMBF *pk_rmbf );

 ER      iref_mbf ( ID mbfid, T_RMBF *pk_rmbf );

パラメータ

I/O	パラメータ	説明
I	ID mbfid;	メッセージ・バッファのID
O	T_RMBF *pk_rmbf;	メッセージ・バッファ詳細情報を格納する領域へのポインタ

【 メッセージ・バッファ詳細情報T_RMBFの構造 】

typedef struct t_rmbf { ID stskid; /*メッセージ送信待ちタスクの有無*/ ID rtskid; /*メッセージ受信待ちタスクの有無*/ UINT smsgcnt; /*未受信メッセージの総数*/ SIZE fmbfsz; /*空き領域のサイズ*/ } T_RMBF;

機能

mbfidで指定されたメッセージ・バッファのメッセージ・バッファ詳細情報（待ちタスクの有無，未受信データの総数など）をpk_rmbfで指定された領域に格納します。

- stskid
メッセージ・バッファの送信待ちキューにタスクがキューイングされているか否かが格納されます。

TSK_NONE： 送信待ちキューにタスクはキューイングされていない

その他： 送信待ちキューの先頭にキューイングされているタスクのID

- rtskid
メッセージ・バッファの受信待ちキューにタスクがキューイングされているか否かが格納されます。

TSK_NONE： 受信待ちキューにタスクはキューイングされていない

その他： 受信待ちキューの先頭にキューイングされているタスクのID

- smsgcnt
メッセージ・バッファに格納されている未受信メッセージ総数が格納されます。

- fmbfsz
メッセージ・バッファの空き領域のサイズ(単位：バイト）が格納されます。

戻り値

マクロ	数値	意味
E_OK	0	正常終了
E_PAR	-17	パラメータ・エラー - pk_rmbf == NULL
E_ID	-18	不正ID番号 - mbfid≦0 - mbfid > VTMAX_MBF
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。 備考 タスクからiref_mbfを発行した場合，および非タスクからref_mbfを発行した場合，コンテキスト・エラーは検出されず，システムの正常な動作は保証されません。
E_MACV	-26	メモリ・アクセス違反（ref_mbfのみ） - 呼び出しタスクからのpk_rmbfが示す領域に対するオペランド・ライト・アクセス許可がない。
E_NOEXS	-42	オブジェクト未生成 - mbfidのメッセージ・バッファが存在しない。