tk_rel_mpf

Release Fixed-size Memory Block

[C Language Interface]

ER ercd = tk_rel_mpf ( ID mpfid, VP blf ) ;

[Parameters]

ID mpfid Fixed-size memory pool ID

VP blf Memory block start address

[Return Parameters]

ER ercd Error code

[Error Codes]

E_OK Normal completion

E_ID Invalid ID number (mpfid is invalid or cannot be used)

E_NOEXS Object does not exist (the .xed-size memory pool specified in mpfid does not exist)

E_PAR Parameter error (blf is invalid, or block returned to wrong memory pool)

[Description]

Returns the memory block specified in blf to the .xed-size memory pool specified in mpfid.

Executing tk_rel_mpf may enable memory block acquisition by another task waiting to allocate memory from the memory pool specified in mpfid, releasing the WAIT state of that task.

When a memory block is returned to a .xed-size memory pool, it must be the same .xed-size memory pool from which the block was allocated. If an attempt to return a memory block to a di.erent memory pool is detected, error code E_PAR is returned. Whether this error detection is made or not is implementation-dependent.

Comments