OS_SwitchThreadCallback

# OS_SetSwitchThreadCallback

## 構文

      #include <nitro/os.h>

  `typedef void (*OSSwitchThreadCallback)(
  OSThread* from,
  OSThread* to );`
  `OSSwitchThreadCallback OS_SetSwitchThreadCallback(
  OSSwitchThreadCallback callback );`

## 引数

callback | スレッド切り替え時のコールバック関数。NULLを指定するとコールバックを解除します。

## 返り値

この関数を呼ぶ前に設定されていたコールバック。設定されていない場合はNULLです。

## 説明

スレッドのコンテキストスイッチが発生したときに呼ばれるコールバック関数を登録します。

一度登録すれば、変更や解除をしない限りそのコールバックはコンテキストスイッチが発生するたびに呼ばれます。

callback は２つの引数を取ります。from はスイッチの前に実行していたスレッドの `OSThread` 構造体へのポインタです。to は次に実行するスレッドの `OSThread` 構造体へのポインタです。実行する準備が出来ていない場合、`NULL` となります。

## 参照

`OS_InitThread, OS_RescheduleThread`

## 履歴

2004/03/31 初版