NNS_FndResizeForMBlockExpHeap

構文

#include <nnsys/fnd.h>
u32 NNS_FndResizeForMBlockExpHeap(
        NNSFndHeapHandle    heap,
        void*               memBlock,
        u32                 size);

引数

heap 拡張ヒープのハンドル
memBlock サイズを変更するメモリブロックへのポインタ
size 変更するメモリブロックのサイズ(バイト)

返り値

関数が成功した場合、変更されたメモリブロックのサイズ(バイト)を返します。 関数が失敗した場合、0 を返します。

説明

拡張ヒープから確保されたメモリブロックのサイズを変更します。

メモリブロックを今の大きさよりも大きくするとき、メモリブロックの後方にサイズを拡張するのに十分な空き領域が存在する必要があります。 十分な空き領域が存在しない場合は、関数は失敗し 0を返します。メモリブロックのサイズを大きくできた場合、メモリブロックの大きさが要求したサイズよりも大きい場合があります。

メモリブロックを今の大きさより小さくするとき、小さくするサイズが数バイト程度と少ない場合は空き領域が作成できず、縮小できない場合があります。 そのときは、現在のメモリブロックのサイズを返します。

参照

NNS_FndAllocFromExpHeap, NNS_FndAllocFromExpHeapEx, NNS_FndCreateExpHeap, NNS_FndCreateExpHeapEx

履歴

2004/10/15 「参照」が見出しになっていなかったのを修正した。
2004/04/01 初版