pget_mpf

概要

メモリ・ブロックの獲得(ポーリング)

C言語形式

 ER      pget_mpf ( ID mpfid, VP *p_blk );
 

アセンブリ言語形式

 MOVW    BC, #LOWW(_p_blk)
 MOV     A, #mpfid
 CALL    !!_pget_mpf
 

パラメータ

I/O

パラメータ

説明

I

 ID      mpfid;
固定長メモリ・プールのID

O

 VP      *p_blk;
メモリ・ブロックの先頭アドレスを格納する領域へのポインタ

 

機能

mpfidで指定された固定長メモリ・プールからメモリ・ブロックを獲得し,その先頭アドレスをp_blkで指定された領域に格納します。

ただし,本サービス・コールを発行した際,対象固定長メモリ・プールからメモリ・ブロックを獲得することができなかった(空きメモリ・ブロックが存在しなかった)場合には,メモリ・ブロックの獲得処理は実行されず,戻り値として“E_TMOUT”が返されます。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_TMOUT

-50

対象固定長メモリ・プールに空きメモリ・ブロックが存在しない