#include <nitro/wm.h>
typedef struct WMPortRecvCallback
{
u16 apiid;
u16 errcode;
u16 state;
u16 port;
WMMpRecvBuf* recvBuf;
u16* data;
u16 length;
u16 aid;
u8 macAddress[6];
u16 seqNo;
void* arg;
u16 myAid;
u16 connectedAidBitmap;
u8 ssid[24];
u16 reason;
u16 rsv;
} WMPortRecvCallback;
apiid | This is the ID of the API that acts as the source for the callback generation. It is synonymous to the WMApiid enumerated type. This argument is fixed to WM_APIID_PORT_RECV . |
errcode | This is the result of the asynchronous process. It is synonymous to the WMErrCode enumerated type. |
state | If errcode is WM_ERRCODE_SUCCESS , the cause code generated by the callback is stored. The following three triggers can be generated: WM_STATECODE_PORT_RECV ,WM_STATECODE_CONNECTED ,WM_STATECODE_DISCONNECTED . |
port | Stores the port that received the data. |
recvBuf | This member was prepared for compatibility with WMStartMPCallback . |
data | Stores the address of the buffer that received the data. |
length | Stores the length of the received data. |
aid | Stores the AID of the source that sent the received data. Note that the WM_STATECODE_CONNECTED acknowledgement also contains the AID of the other machine. If a parent machine, it is fixed at 0 (the parent's AID). |
macAddress | When the state is WM_STATECODE_CONNECTED or WM_STATECODE_DISCONNECTED , stores the MAC address of the connected or disconnected child. |
seqNo | Stores the sequence number. |
arg | Stores the argument that is specified by the WM_SetPortCallback function. |
myAid | Stores this machine's AID. |
connectedAidBitmap | The AID bitmap during connection is stored. |
ssid | Stores the ssid specified by the child using WM_StartConnect . Only valid during parent's WM_STATECODE_CONNECTED acknoweledgement. |
reason | Stores the code showing the reason for disconnection when the state is WM_STATECODE_DISCONNECTED . This member is used internally in the library for debugging. |
rsv | Reserved. |
This structure is passed to the callback function that is set by the WM_SetPortCallback
function.
11/14/2005 Restored the description of the rsv
member that was mistakenly deleted.
10/31/2005 Deleted rsv
members and added connectedAidBitmap
and reason
members.
02/01/2005 Added explanations of myAid
and ssid
members.
10/05/2004 Standardized MAC address as u8 type
09/13/2004 Changed WM_STATECODE_CHILD_CONNECTED
to WM_STATECODE_CONNECTED
08/11/2004 Initial version.