osCreateRegion.htm 3.97 KB

Raw Blame History Permalink

<HTML>

<HEAD>

<TITLE>HTML 文書</TITLE>

<META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.0j">
</HEAD>

<BODY>

<P>
<B><FONT FACE="Arial">osCreateRegion(3P) <BR>
</FONT></B>
<P>
<B>関数名<BR>
</B>
<P>
osCreateRegion, osMalloc, osFree, osGetRegionBufCount,
osGetRegionBufSize
<P>
→ 任意の範囲のメモリを配置するルーチン<BR>

<P>
<B>構文<BR>
</B>
<P>
#include &lt;ultra64.h&gt;
<P>
<B>void *osCreateRegion(void *startAddress, u32 length,
u32 bufferSize, u32 alignSize);</B>
<P>
void *osMalloc(void *region);
<P>
void osFree(void *region, void *addr);
<P>
long osGetRegionBufCount(void *region);
<P>
long osGetRegionBufSize(void *region);<BR>

<P>
<B>説明<BR>
</B>
<P>
これらのルーチンは、メモリ配置のためのシンプルかつ高速なメカニズムを供給し、任意のメモリエリアから固定サイズのバッファを解放します。リージョンはユーザーによって定義された物理的に連続したメモリブロックであり､メモリリージョンは<B>osCreateRegion</B>コールを使用することにより､実行中にいくつでも生成することができます｡ユーザーはコントロールストラクチャのための一定のオーバーヘッドを含むバッファサイズのための十分大きなメモリブロックを供給しなければなりません｡
<BR>

<P>
このメモリ配置スキムは入力メモリエリアの先頭の数バイトにリージョンコントロールヘッダをとります。残りの範囲は単に、同サイズのバッファを並べていきます。バッファサイズはalignSizeで定義されたバイト数にそろえられます｡
<BR>

<P>
生成中に､それぞれのリージョンには一意的にリージョンIDが与えられます。ユーザーはこのidを用いてリージョンにアクセスします。実際にはidはリージョンへのコントロールヘッダアドレスですから､リージョンへはダイレクトにアクセスすることになり、サーチなどを行うことはありません。
<BR>

<P>
2つのシンプルなコールosMallocとosFreeは，高速な動的メモリをバッファに配置，解放します｡サーチすることなく､osMallocは領域のフリーリストの先頭のバッファを獲得し､osFreeはフリーリストの先頭にバッファを置きます｡
<BR>

<P>
<B>osCreateRegion</B>ルーチンはstartAddressアドレスに始まりlengthバイトまで続いた連続するメモリエリアをリージョンとして生成します｡この領域は少なくともbufferSize(byte)のサイズのバッファを含むようにイニシャライズされます｡alignSizeはバッファアドレスとサイズをそろえるために使用されるバイト数(2,4,8,16byteを含む)を指定します｡これらの数値はregion.h中にOS_RG_ALIGN_2B,
OS_RG_ALIGN_4B, OS_RG_ALIGN_8B, OS_RG_ALIGN_16Bとそれぞれ定義されています｡もしalignSizeが0であれば､デフォルト値(OS_RG_ALIGN_DEFAULTは8byte(64bit)です｡)が使用されます｡
<P>
<B>osCreateRegion</B>は領域リージョンの開始アドレスをポインタとして返します｡このポインタは､他のリージョンルーチンで一意的なリージョンidとして使用されます｡
<BR>

<P>
osMallocはリージョン内のバッファへのポインタを返します｡それはalignSize(byte)にアラインされています。バッファサイズはosCreateRegionルーチンをコールしているときに定義されます。
<BR>

<P>
osFreeの中の引数addrは､osMallocによって前もって割り当てられたバッファへのポインタです｡osFreeはバッファアドレスのチェックを実行した後に､リージョンのフリーリストにこのバッファを返します｡
<BR>

<P>
osGetRegionBufCountはリージョン中に生成されたバッファの総数を返します｡同様にosGetRegionBufSizeは､リージョン中のそれぞれのバッファに割り当てられたサイズ(byte)を返します｡
<BR>

<P>
<B>特徴<BR>
</B>
<P>
<B>osCreateRegion</B>は以下の状態に遭遇すれば､NULLポインタを返します｡
<BR>

<P>
(1) スタートアドレスがない場合｡
<P>
(2) 長さまたはバッファサイズが0以下の場合｡
<P>
(3) バッファアドレスがストアデータから蓄えられた実際の長さよりも大きくなった場合｡
<BR>

<P>
リージョン中に利用できるフリーバッファがない場合は､osMallocはNULLを返すでしょう｡
<BR>

<P>
<B>注意<BR>
</B>
<P>
通常は､リージョンには最大32,768のバッファまでしか持つことができません｡その上イニシャライズ中､リージョンのスタートアドレスは自動的にalignSize境界に整列され､同様に､そのバッファサイズ(byte)もalignSizeに整列されます。
<P>
ユーザーは同じメモリアドレスを指す複数のリージョンを生成しないように､特に注意しなければいけません｡リージョン生成中のメモリチェックはなにも行わないので､アドレスが重なった場合の動作は保証できません。
<BR>

</BODY>

</HTML>