# WM_GetAllowedChannel

## 構文

      #include <nitro/wm.h>

      u16 WM_GetAllowedChannel( void );

## 引数

なし。

## 返り値

無線の1〜14chのうち、使用を許可されたチャンネル群のビットフィールドを返します。 最下位ビットから順に 1 チャンネル, 2 チャンネル……に対応します。 また、初期化前などWMが不適切な状態の時に呼び出されるとエラーを示す0x8000を返します。

## 説明

無線通信において使用すべきチャンネルを取得します。WMがIDLEステートの場合のみ実行可能です。
例えば 0x1041 が返された場合は、1、7、13 チャンネルが使用を許可されたチャンネルとなります。
WM_SetParentParameter( )にて親機として活動を開始するチャンネルを指定する際にこの関数で得られたチャンネルのいずれかを指定しなければなりません。 各チャンネルの電波状況を調べるには、WM_MeasureChannel( )を使用して下さい。
また、WM_StartScan( )にて子機として親機をスキャンする場合には、この関数で得られたチャンネルのいずれかで親機が 活動しているはずですので、スキャンすべきチャンネルを絞ることができます。但しインフラストラクチャモードの場合には この限りではありません。

## 注意

この関数に0が返された場合は、使用すべきチャンネルが無い、つまり無線で通信してはいけないことを示します。 無線通信が禁止された特殊な環境で使用される本体であった場合などに0が返される可能性がある点に注意して下さい。

## 参照

`WM_SetParentParameter, WM_StartParent, WM_MeasureChannel, WM_StartScan`

## 履歴

2004/10/27 返り値にエラー値の記述を加筆
2004/09/25 説明を加筆・修正
2004/08/20 初版