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