pget_mpf

Outline

Acquire fixed-sized memory block (polling).

C format

 ER      pget_mpf ( ID mpfid, VP *p_blk );


Assembly format

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


Parameter(s)

I/O

Parameter

Description

I

 ID      mpfid;
ID number of the fixed-sized memory pool from which a memory block is acquired.

O

 VP      *p_blk;
Start address of the acquired memory block.



Explanation

This service call acquires the memory block from the fixed-sized memory pool specified by parameter mpfid and stores the start address in the area specified by parameter p_blk.

If a memory block could not be acquired from the target fixed-sized memory pool (no available memory blocks exist) when this service call is issued, memory block acquisition processing is not performed but "E_TMOUT" is returned.

Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_TMOUT

-50

Polling failure.