#include <nitro/os.h>BOOL OS_RestoreCallTrace( BOOL enable );
| enable | セットする関数コールトレースの状態(有効／無効) |
この関数を呼ぶ前の状態です。TRUE なら enable であったことを表し、FALSE なら disable であったことを表します。
関数コールトレースの機能を有効または無効に設定にします。
このスイッチは、profile機能で挿入される、関数の入り口と出口の__PROFILE_ENTRY、__PROFILE_EXIT が有効になるかどうかを決定します。スタックモードで関数コールトレース機能を使用する場合には、有効／無効の切り替えを行なうタイミングに注意して下さい。例えば、disable状態であったときに test() という関数をコールしてその中で enable 状態にすると、関数の入り口__PROFILE_ENTRY では 何もしなかったのに、__PROFILE_EXIT でスタックから情報を捨てようとして整合性が取れません。ログモードでは__PROFILE_ENTRY で記録を取るだけなので、どこで状態を変更しても構いません。
有効・無効のスイッチは、トレースバッファごとにセットされますので、全体が enable や disable に切り替わるわけではありません。
この関数はデバッグ用の関数ですので、最終ROM版(FINALROM)ライブラリでは何も動作を行ないません。
OS_InitCallTrace, OS_EnableCallTrace, OS_DisableCallTrace
2004/04/23 初版