NNS_GfdFreePlttVram

構文

#include <nnsys/gfd.h>
int NNS_GfdFreePlttVram(NNSGfdPlttKey plttKey);

引数

plttKey 確保したパレット用メモリを示すキー・データ

返り値

パレット用メモリの解放に成功した場合、0が返ります。

説明

plttKeyで指定されたパレット用メモリを解放します。 NITRO-Systemのライブラリがパレット用メモリを解放する場合には、この関数が使用されます。

NNS_GfdFreePlttVram関数は以下のように定義されており、内部処理は グローバルな関数ポインタであるNNS_GfdDefaultFuncFreePlttVramに設定されている関数を呼び出しているのみとなっています。

static inline int
NNS_GfdFreePlttVram(NNSGfdPlttKey key)
{
    return (*NNS_GfdDefaultFuncFreePlttVram)(key);
}

この関数ポインタに適当なパレット用メモリ解放関数を登録する事により、NNS_GfdFreePlttVramは機能します。 このような仕組みにより、ライブラリからのパレット用メモリの解放をユーザ側でコントロールする事を可能にしています。 なお初期状態では、NNS_GfdDefaultFuncFreePlttVramには、何も処理をせずにエラーを返す関数が設定されています。

参照

NNS_GfdAllocPlttVram

履歴

2004/07/16 初版