# WMStartParentCallback

## 定義

  `#include <nitro/wm.h>`

      typedef struct WMStartParentCallback
      {
          u16     apiid;
          u16     errcode;
          u16     wlCmdID;
          u16     wlResult;
          u16     state;
          u8      macAddress[6];
          u16     aid;
          u16     reason;
          u8      ssid[WM_SIZE_CHILD_SSID];

      } WMStartParentCallback;

## 要素

apiid | コールバック発生の元となったAPIのIDです。WMApiid列挙型と同義です。 ここではWM_APIID_START_PARENTに固定となります。
errcode | 非同期処理の結果です。WMErrCode列挙型と同義です。
wlCmdID | errcodeがWM_ERRCODE_FAILEDの場合、無線ファームウェアでエラーとなったコマンドのIDが格納されます。
wlResult | errcodeがWM_ERRCODE_FAILEDの場合、無線ファームウェアでエラーとなった要因コードが格納されます。
state | errcodeがWM_ERRCODE_SUCCESSの場合、コールバックの発生した要因種別が格納されます。発生しうる要因は以下の5つです。 WM_STATECODE_PARENT_START、WM_STATECODE_CONNECTED、WM_STATECODE_BEACON_SENT、WM_STATECODE_DISCONNECTED、WM_STATECODE_DISCONNECTED_FROM_MYSELF。
macAddress | stateがWM_STATECODE_CONNECTEDの場合に、接続した子機のMACアドレスが格納されます。 また、stateがWM_STATECODE_DISCONNECTED、WM_STATECODE_DISCONNECTED_FROM_MYSELFの場合に、切断された子機のMACアドレスが格納されます。
aid | stateがWM_STATECODE_CONNECTEDの場合に、接続した子機に割り当てたAIDが格納されます。 また、stateがWM_STATECODE_DISCONNECTED、WM_STATECODE_DISCONNECTED_FROM_MYSELFの場合に、切断された子機に割り当てていたAIDが格納されます。
reason | stateがWM_STATECODE_DISCONNECTED、WM_STATECODE_DISCONNECTED_FROM_MYSELFの場合、切断された理由を示すコードが格納されます。 ライブラリ内部で使用されるデバッグ目的のメンバです。
ssid | 子機がWM_StartConnectで指定したssidが格納されます。

## 説明

WM_StartParent( )に対するコールバック関数に渡される構造体です。

## 履歴

2006/02/17 stateに返るコードに関する記述を修正
2004/11/10 reasonメンバについての説明を追記
2004/10/05 MACアドレスをu8型配列に統一
2004/09/13 WM_STATECODE_CHILD_CONNECTED を WM_STATECODE_CONNECTED に変更
2004/08/23 引数ssidを追加
2004/08/02 構造体名の統一
2004/07/29 初版