Everything

ref_mpf

iref_mpf

概要
固定長メモリ・プール詳細情報の参照
C言語形式
 ER      ref_mpf ( ID mpfid, T_RMPF *pk_rmpf );
 ER      iref_mpf ( ID mpfid, T_RMPF *pk_rmpf );
パラメータ
I/O
パラメータ
説明
I
 ID      mpfid;
固定長メモリ・プールのID
O
 T_RMPF  *pk_rmpf;
固定長メモリ・プール詳細情報を格納する領域へのポインタ

【 固定長メモリ・プール詳細情報T_RMPFの構造 】
 typedef struct  t_rmpf {
         ID      wtskid;         /*待ちタスクの有無*/
         UINT    fblkcnt;        /*空きメモリ・ブロックの総数*/
  } T_RMPF;

機能
mpfidで指定された固定長メモリ・プールの固定長メモリ・プール詳細情報(待ちタスクの有無,空き固定長メモリ・ブロックの総数など)をpk_rmpfで指定された領域に格納します。
- wtskid
固定長メモリ・プールの待ちキューにタスクがキューイングされているか否かが格納されます。
TSK_NONE: 待ちキューにタスクはキューイングされていない
その他: 待ちキューの先頭にキューイングされているタスクのID
- fblkcnt
空きメモリ・ブロックの総数が格納されます。
戻り値
マクロ
数値
意味
E_OK
0
正常終了
E_PAR
-17
パラメータ・エラー
- pk_rmpf == NULL
E_ID
-18
不正ID番号
- mpfid≦0
- mpfid > VTMAX_MPF
E_CTX
-25
コンテキスト・エラー
- CPUロック状態から本サービス・コールを発行した。
- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。
備考 タスクからiref_mpfを発行した場合,および非タスクからref_mpfを発行した場合,コンテキスト・エラーは検出されず,システムの正常な動作は保証されません。
E_MACV
-26
メモリ・アクセス違反(ref_mpfのみ)
- 呼び出しタスクからのpk_rmpfが示す領域に対するオペランド・ライト・アクセス許可がない。
E_NOEXS
-42
オブジェクト未生成
- mpfidの固定長メモリ・プールが存在しない。