Everything

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のメッセージ・バッファが存在しない。