開発ツール

ref_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;

 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_ID	-18	不正ID番号 - mbfid≦0 - mbfid＞VTMAX_MBF
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。備考タスクからiref_mbfを発行した場合，および非タスクからref_mbfを発行した場合，コンテキスト・エラーは検出されず，システムの正常な動作は保証されません。