# OS_DisableCallTrace

## 構文

  `#include <nitro/os.h>`
  `BOOL OS_DisableCallTrace( void );`

## 引数

なし。

## 返り値

この関数を呼ぶ前の状態です。TRUE なら enable であったことを表し、FALSE なら disable であったことを表します。

## 説明

関数コールトレースの機能を無効にします。

このスイッチは、profile機能で挿入される、関数の入り口と出口の__PROFILE_ENTRY、__PROFILE_EXIT が有効になるかどうかを決定します。スタックモードで関数コールトレース機能を使用する場合には、有効／無効の切り替えを行なうタイミングに注意して下さい。例えば、disable状態であったときに `test()` という関数をコールしてその中で enable 状態にすると、関数の入り口__PROFILE_ENTRY では 何もしなかったのに、__PROFILE_EXIT でスタックから情報を捨てようとして整合性が取れません。ログモードでは__PROFILE_ENTRY で記録を取るだけなので、どこで状態を変更しても構いません。

有効・無効のスイッチは、トレースバッファごとにセットされますので、全体が disable になるわけではありません。

この関数はデバッグ用の関数ですので、最終ROM版(FINALROM)ライブラリでは何も動作を行ないません。

## 参照

`OS_InitCallTrace, OS_EnableCallTrace, OS_RestoreCallTrace
`

## 履歴

2004/04/23 初版