# WM_MeasureChannel

## 構文

      #include <nitro/wm.h>

      WMErrCode WM_MeasureChannel(
              WMCallbackFunc  callback,
              u16             ccaMode ,
              u16             edThreshold ,
              u16             channel ,
              u16             measureTime
      );

## 引数

callback | 非同期処理が完了した時に呼び出されるコールバック関数を指定します。 このコールバックは割り込みハンドラ内から呼び出されます。

ccaMode

測定動作モードを以下の 0 〜 3 の値から指定して下さい。

- 0 ： キャリアセンスモード。ニンテンドーDSのワイヤレス通信に影響する強度の電波についてのみ測定します。
- 1 ： ED閾値指定モード。edThresholdに指定した電波強度以上の電波について測定します。
- 2 ： キャリアセンスとED閾値の論理積に該当する強度の電波について測定します。
- 3 ： キャリアセンスとED閾値の論理和に該当する強度の電波について測定します。

edThreshold | キャリアセンスモードでない場合に、測定する電波強度の下限を指定します。 0 〜 61 ( -60dBm 〜 -80dBm ) の値を指定してください。
channel | 調査するチャンネルを指定します。 1 〜 14 の値を指定して下さい。
measureTime | 調査する期間を 1 ms単位で指定します。1 以上の値を指定して下さい。

## 返り値

WMErrCode列挙型の処理結果を返します。

## 説明

指定チャンネルの電波使用率を測定します。WMステートがIDLEステートの場合に実行可能です。 APIの戻り値がWM_ERRCODE_OPERATINGであった場合、電波使用率の測定が完了した後にコールバックが発生します。

## 履歴

2005/06/08 コールバックが割り込みハンドラから呼び出される旨を補足
2005/03/02 説明追記
2004/10/22 返り値の型を変更
2004/08/11 初版