1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<title>WMGetWirelessCounterCallback</title>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</head>
10<body>
11<h1 align="left">WMGetWirelessCounterCallback</h1>
12<h2>Definition</h2>
13<dl>
14  <dd>
15<CODE>#include &lt;nitro/wm.h&gt;</CODE><BR>
16  <PRE><CODE>typedef struct WMGetWirelessCounterCallback
17{
18    u16     apiid;
19    u16     errcode;
20    u16     wlCmdID;
21    u16     wlResult;
22    u32     TX_Success;
23    u32     TX_Failed;
24    u32     TX_Retry;
25    u32     TX_AckError;
26    u32     TX_Unicast;
27    u32     TX_Multicast;
28    u32     TX_WEP;
29    u32     TX_Beacon;
30    u32     RX_RTS;
31    u32     RX_Fragment;
32    u32     RX_Unicast;
33    u32     RX_Multicast;
34    u32     RX_WEP;
35    u32     RX_Beacon;
36    u32     RX_FCSError;
37    u32     RX_DuplicateError;
38    u32     RX_MPDuplicateError;
39    u32     RX_ICVError;
40    u32     RX_FrameCtrlError;
41    u32     RX_LengthError;
42    u32     RX_PLCPError;
43    u32     RX_BufferOverflowError;
44    u32     RX_PathError;
45    u32     RX_RateError;
46    u32     RX_FCSOK;
47    u32     TX_MP;
48    u32     TX_KeyData;
49    u32     TX_NullKey;
50    u32     RX_MP;
51    u32     RX_MPACK;
52    u32     MPKeyResponseError[15];
53} WMGetWirelessCounterCallback;</CODE></PRE>
54  </dd>
55</dl><h2>Elements</h2>
56<TABLE border="1" width="100%">
57  <TBODY>
58    <TR>
59<TD width="200"><CODE>apiid</CODE></TD>
60<TD width="800">ID of the API that acts as the source for the callback generation. It is equivalent to the <A href="WMApiid.html"><code>WMApiid</code></A> enumerated type. Fixed here by <code>WM_APIID_GET_W_COUNTER</code>.
61      </TD>
62    </TR>
63    <TR>
64<TD width="200"><CODE>errcode</CODE></TD>
65<TD width="800">Result of the asynchronous process. It is equivalent to the <A href="WMErrCode.html"><code>WMErrCode</code></A> enumerated type.</TD>
66    </TR>
67    <TR>
68<TD width="200"><CODE>wlCmdID</CODE></TD>
69<TD width="800">If <CODE>errcode</CODE> is <code>WM_ERRCODE_FAILED</code>, this function will store the ID of the command that was in error in the wireless firmware.</TD>
70    </TR>
71    <TR>
72<TD width="200"><CODE>wlResult</CODE></TD>
73<TD width="800">If <CODE>errcode</CODE> is <code>WM_ERRCODE_FAILED</code>, this function will store the code was the source of the error in the wireless firmware.</TD>
74    </TR>
75    <TR>
76<TD width="200"><CODE>TX_Success</CODE></TD>
77<TD width="800">Number of times that the function was able to send normally.</TD>
78    </TR>
79    <TR>
80<TD width="200"><CODE>TX_Failed</CODE></TD>
81<TD width="800">Number of times that the function failed to send normally.</TD>
82    </TR>
83    <TR>
84<TD width="200"><CODE>TX_Retry</CODE></TD>
85<TD width="800">Number of times that the function retried.</TD>
86    </TR>
87    <TR>
88<TD width="200"><CODE>TX_AckError</CODE></TD>
89<TD width="800">Number of times the function was unable to receive the desired ACK frame.</TD>
90    </TR>
91    <TR>
92<TD width="200"><CODE>TX_Unicast</CODE></TD>
93<TD width="800">Number of Unicast address frames that were sent normally.</TD>
94    </TR>
95    <TR>
96<TD width="200"><CODE>TX_Multicast</CODE></TD>
97<TD width="800">Number of Multicast address frames that were sent normally.</TD>
98    </TR>
99    <TR>
100<TD width="200"><CODE>TX_WEP</CODE></TD>
101<TD width="800">Number of code frames that were sent normally.</TD>
102    </TR>
103    <TR>
104<TD width="200"><CODE>TX_Beacon</CODE></TD>
105<TD width="800">Number of Beacon frames that were sent normally.</TD>
106    </TR>
107    <TR>
108<TD width="200"><CODE>RX_RTS</CODE></TD>
109<TD width="800">Number of times the function received RTS and performed CTS response. (See note.)</FONT></TD>
110    </TR>
111    <TR>
112<TD width="200"><CODE>RX_Fragment</CODE></TD>
113<TD width="800">Number of times fragmented frames were received.</TD>
114    </TR>
115    <TR>
116<TD width="200"><CODE>RX_Unicast</CODE></TD>
117<TD width="800">Number of times Unicast address frames were received.</TD>
118    </TR>
119    <TR>
120<TD width="200"><CODE>RX_Multicast</CODE></TD>
121<TD width="800">Number of times Multicast address frames were received.</TD>
122    </TR>
123    <TR>
124<TD width="200"><CODE>RX_WEP</CODE></TD>
125<TD width="800">Number of times code frames were received that could be decoded normally. (See note.)</FONT></TD>
126    </TR>
127    <TR>
128<TD width="200"><CODE>RX_Beacon</CODE></TD>
129<TD width="800">Number of times that beacon frames were received.</TD>
130    </TR>
131    <TR>
132<TD width="200"><CODE>RX_FCSError</CODE></TD>
133<TD width="800">Number of times FCS errors occurred. (See note.)</FONT></TD>
134    </TR>
135    <TR>
136<TD width="200"><CODE>RX_DuplicateError</CODE></TD>
137<TD width="800">Number of occurrences of duplication errors. (See note.)</FONT></TD>
138    </TR>
139    <TR>
140<TD width="200"><CODE>RX_MPDuplicateError</CODE></TD>
141<TD width="800">Number of occurrences of MP frame duplication errors. (See note.)</FONT></TD>
142    </TR>
143    <TR>
144<TD width="200"><CODE>RX_ICVError</CODE></TD>
145<TD width="800">Number of occurrences of ICV errors. (See note.)</FONT></TD>
146    </TR>
147    <TR>
148<TD width="200"><CODE>RX_FrameCtrlError</CODE></TD>
149<TD width="800">Number of times frames having illegal <CODE>FrameCtrl</CODE> were received. (See note.)</FONT></TD>
150    </TR>
151    <TR>
152<TD width="200"><CODE>RX_LengthError</CODE></TD>
153<TD width="800">Number of times frames shorter or longer than the set length were received. (See note.)</FONT></TD>
154    </TR>
155    <TR>
156<TD width="200"><CODE>RX_PLCPError</CODE></TD>
157<TD width="800">Number of occurrences of CRC errors of the PLCP. (See note.)</FONT></TD>
158    </TR>
159    <TR>
160<TD width="200"><CODE>RX_BufferOverflowError</CODE></TD>
161<TD width="800">Number of times the receive buffer overflowed. (See note.)</FONT></TD>
162    </TR>
163    <TR>
164<TD width="200"><CODE>RX_PathError</CODE></TD>
165<TD width="800">Number of occurrences of errors in the receive block. (See note.)</FONT></TD>
166    </TR>
167    <TR>
168<TD width="200"><CODE>RX_RateError</CODE></TD>
169<TD width="800">Number of times frames with illegal receive rates were received. (See note.)</FONT></TD>
170    </TR>
171    <TR>
172<TD width="200"><CODE>RX_FCSOK</CODE></TD>
173<TD width="800">Number of times a frame with a normal FCS was received. (See note.)</FONT></TD>
174    </TR>
175    <TR>
176<TD width="200"><CODE>TX_MP</CODE></TD>
177<TD width="800">Number of times an MP frame was sent.</TD>
178    </TR>
179    <TR>
180<TD width="200"><CODE>TX_KeyData</CODE></TD>
181<TD width="800">Number of times MP-KeyData frames were sent.</TD>
182    </TR>
183    <TR>
184<TD width="200"><CODE>TX_NullKey</CODE></TD>
185<TD width="800">Number of times MP-NullKey frames were sent.</TD>
186    </TR>
187    <TR>
188<TD width="200"><CODE>RX_MP</CODE></TD>
189<TD width="800">Number of times normal MP frames were received.</TD>
190    </TR>
191    <TR>
192<TD width="200"><CODE>RX_MPACK</CODE></TD>
193<TD width="800">Number of times normal MPACK frames were received.</TD>
194    </TR>
195    <TR>
196<TD width="200"><CODE>MPKeyResponseError</CODE></TD>
197<TD width="800">Number of times each child did not respond normally to Key requests.</TD>
198    </TR>
199  </TBODY>
200</TABLE>
201<P>
202<FONT color=red><B>Note:</B></FONT> Sometimes a value does not meet the actual total results due to the possibility that the counter in hardware may be cleared unexpectedly.
203</P>
204<H2>Description</H2>
205<P>
206This structure is passed to the callback function for the <A href="WM_GetWirelessCounter.html"><code>WM_GetWirelessCounter</code></A> function.
207</P>
208<H2>Revision History</H2>
209<P>
2102005/11/11 Added a note.<BR>2004/08/11 Initial version.<BR>
211</P>
212<hr><p>CONFIDENTIAL</p></body>
213</html>
214