-
pget_mpl
ipget_mpl
-
ER pget_mpl ( ID mplid, UINT blksz, VP *p_blk );
ER ipget_mpl ( ID mplid, UINT blksz, VP *p_blk );
|
|
|
|
|
|
|
ID mplid;
|
|
|
|
UINT blksz;
|
可変長メモリ・ブロックの要求サイズ（単位：バイト）
|
|
|
VP *p_blk;
|
可変長メモリ・ブロックの先頭アドレスを格納する領域へのポインタ
|
mplidで指定された可変長メモリ・プールから
blkszで指定されたサイズ（+4バイト）の可変長メモリ・ブロックを獲得し，その先頭アドレスを
p_blkで指定された領域に格納します。
ただし，本サービス・コールを発行した際，対象可変長メモリ・プールから可変長メモリ・ブロックを獲得することができなかった（要求サイズ分の連続する空き領域が存在しなかった）場合には，可変長メモリ・ブロックの獲得は行わず，戻り値としてE_TMOUTを返します。
備考1 RI850V4では，可変長メモリ・ブロックの獲得処理を“4の整数倍値”を単位として行います。したがって，
blkszに4の整数倍値以外の値が指定された場合には，4の整数倍値に繰り上げられます。
備考2 RI850V4では，獲得した可変長メモリ・ブロックを管理するために4バイトの領域（管理ブロック）を必要とします。したがって，本サービス・コールを発行した際には，“
blksz + 4”バイトの領域が対象可変長メモリ・プールから確保されることになります。
備考3 RI850V4では，可変長メモリ・ブロックを獲得する際，メモリ・クリア処理を行っていません。したがって，獲得した可変長メモリ・ブロックの内容は不定となります。
備考4 本サービス・コールを発行した際，対象可変長メモリ・プールから可変長メモリ・ブロックを獲得することができなかった（要求サイズ分の連続する空き領域が存在しなかった）場合，
p_blkで指定された領域の内容は不定となります。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- mplid＞生成されている可変長メモリ・プールの最大ID
|
|
|
|
|
|
|
|
|
|
|
|
対象可変長メモリ・プールに要求サイズ分の連続する空き領域が存在しない
|