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 初版