# CAMERA_SwitchOffLED*

## 構文

  `#include <twl/camera.h>`
  `CAMERAResult CAMERA_SwitchOffLED(void);`
  `CAMERAResult CAMERA_SwitchOffLEDAsync(CAMERACallback callback, void *arg);`

## 引数

callback | 非同期処理が完了した際に呼び出す関数
arg | コールバック関数の呼び出し時の引数

## 返り値

設定に成功したらCAMERA_RESULT_SUCCESSを返します。

## 説明

外側カメラランプを点滅一回分の時間 ( 約0.8sec ) だけ消灯するように変更します。
外側カメラランプは、外側カメラをアクティブにした場合に点灯するようになっており、その状態で 本関数を呼び出すことにより、`CAMERA_SetLED()` で 外側カメラランプを点滅状態にした場合の点滅一回分の時間だけ、消灯状態となります。
そのため、外側カメラがアクティブでない場合には失敗することに注意してください。
本関数は `CAMERA_SetLED(TRUE) を呼び出した後に 6msec 待ち、CAMERA_SetLED(FALSE)` を呼び出した場合と同じ動作となります。
そのため、同期版を呼び出した場合は関数内部で 6msec ブロックされることに注意してください。
非同期版を呼び出した場合はブロックされずにすぐに処理が返りますが、呼び出しから 6msec の間、他の CAMERA 関数が使用できなくなる点に 注意してください。
上記の制限が気になるようであれば、個別で `CAMERA_SetLED()` を使用して 消灯を実装してください。

## 参照

`CAMERA_SetLED*`

## 履歴

2009/06/08 点滅の時間についての説明追加
2009/04/15 関数を呼び出すことによる制限について追加
2008/09/09 初版