OS_CalcCallTraceLines

構文

#include <nitro/os.h>

int OS_CalcCallTraceLines( u32 size );

引数

size バッファのサイズ

返り値

確保できるライン数。0の場合は確保できないことをあらわします。

説明

指定のサイズのバッファに対し、関数コールトレース情報が何ライン分確保出来るかを取得します。

sizeOS_InitCallTrace でバッファサイズとして指定する値と同じ意味を持ちます。このバッファの中には、関数呼び出しのトレース情報のほかに、バッファの終端や現在のポインタなどを記録する領域などが取られます。そうしたものを考慮して、指定のバッファサイズでトレース情報を何ライン分確保出来るかを求める関数です。

この関数はデバッグ用の関数ですので、最終ROM版(FINALROM)ライブラリでは必ず0を返します。

参照

OS_InitCallTrace, OS_CalcCallTraceBufferSize

履歴

2004/04/22 初版