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 http-equiv="Content-Style-Type" content="text/css" />
6<link rel="stylesheet" type="text/css" href="../CSS/rex.css" />
7<title>WDBssDesc</title>
8</head>
9<body>
10
11<h1>WDBssDesc</h1>
12
13<h2>C Specification</h2>
14<dl>
15  <dd><pre><code>#include &lt;revolution/wd/WDTypes.h&gt;</code></pre>
16  <dd><pre><code>typedef  struct WDBssDesc_  WDBssDesc;</code></pre>
17  <dd><pre><code>struct WDBssDesc_
18{
19    u16     length;
20    u16     rssi;
21    u8      bssid[ WD_SIZE_BSSID ];
22    u16     ssidLength;
23    u8      ssid[ WD_SIZE_SSID];
24    u16     capaInfo;
25    struct
26    {
27        u16     basic;
28        u16     support;
29    } rateSet;
30    u16     beaconPeriod;
31    u16     dtimPeriod;
32    u16     channel;
33    u16     cfpPeriod;
34    u16     cfpMaxDuration;
35    u16     info_elt_len;
36    u16     info_elt[1];
37};</code></pre>
38</dl>
39
40<h2>Description</h2>
41<p>
42	The structure types for the BSS indicator at the head of the BSS information.
43</p>
44<table border="1" cellpadding="3" cellspacing="0.1">
45	<tr>
46		<TH><em>length</em></TH>
47		<TD>The size of the entire BSS information in half word units (two bytes).</TD>
48	</tr>
49	<tr>
50		<TH><em>rssi</em></TH>
51		<TD>
52			The received signal strength indication (RSSI). Use the <CODE><a href="WDGetRadioLevel.html">WDGetRadioLevel</a></CODE> function to convert into the four levels of signal strength.
53		</TD>
54	</tr>
55	<tr>
56		<TH><em>bssid</em></TH>
57		<TD>The six-byte basic service set ID (BSSID). Normally the same as the target MAC address.</TD>
58	</tr>
59	<tr>
60		<TH><em>ssidLength</em></TH>
61		<TD>The size in bytes of the service set ID (SSID), with a maximum of 32 bytes.</TD>
62	</tr>
63	<tr>
64		<TH><em>ssid</em></TH>
65		<TD>The SSID. Its size is indicated in <CODE><strong><em>ssidLength</em></strong></CODE>.</TD>
66	</tr>
67	<tr>
68		<TH><em>capaInfo</em></TH>
69		<TD>The 16-bit capability information. It comprises the bits for the SS type, the preamble settings, the privacy settings, etc.</TD>
70	</tr>
71	<tr>
72		<TH><em>rateSet</em></TH>
73		<TD>
74			The transfer data rate.
75			<table border="1" cellpadding="3" cellspacing="0.1">
76				<tr>
77					<TH><em>basic</em></TH>
78					<TD>The corresponding basic transfer rate is stored in a bit field format.</TD>
79				</tr>
80				<tr>
81					<TH><em>support</em></TH>
82					<TD>The corresponding support transfer rate is stored in a bit field format.</TD>
83				</tr>
84			</table>
85		</TD>
86	</tr>
87	<tr>
88		<TH><em>beaconPeriod</em></TH>
89		<TD>The beacon send interval in time units (TU). 1 TU is 1024 microseconds, or approximately one millisecond.</TD>
90	</tr>
91	<tr>
92		<TH><em>dtimPeriod</em></TH>
93		<TD>The delivery traffic indication message (DTIM) interval based on the number of times the beacon is sent.</TD>
94	</tr>
95	<tr>
96		<TH><em>channel</em></TH>
97		<TD>The wireless channel used for data transfer.</TD>
98	</tr>
99	<tr>
100		<TH><em>cfpPeriod</em></TH>
101		<TD>The CF (contention free) period, based on the the number of times the beacon is sent, when the target supports CF operations.</TD>
102	</tr>
103	<tr>
104		<TH><em>cfpMaxDuration</em></TH>
105		<TD>The maximum CF period, in TUs, when the target supports the use of CF.</TD>
106	</tr>
107	<tr>
108		<TH><em>info_elt_len</em></TH>
109		<TD>The size in bytes of the element information unique to the target.</TD>
110	</tr>
111	<tr>
112		<TH><em>info_elt</em></TH>
113		<TD>
114			Indicates the location where the element information unique to the target is stored. Data is stored consecutively from this position for a length equal to that indicated in <CODE><strong><em>info_elt_len</em></strong></CODE>. Use <CODE><a href="WDFindInformationElement.html">WDFindInformationElement</a></CODE>, <CODE><a href="WDFindWifiProtectedAccess.html">WDFindWifiProtectedAccess</a></CODE> or <CODE><a href="WDFindGameInfo.html">WDFindGameInfo</a></CODE> to extract the specific element information.
115		</TD>
116	</tr>
117</table>
118
119<h2>See Also</h2>
120<p>
121	<CODE><a href="WDScanOnce.html">WDScanOnce</a><br> <a href="WDGetPrivacyMode.html">WDGetPrivacyMode</a><br> <a href="WDFindInformationElement.html">WDFindInformationElement</a><br> <a href="WDFindWifiProtectedAccess.html">WDFindWifiProtectedAccess</a><br> <a href="WDFindGameInfo.html">WDFindGameInfo</a><br> <a href="WDGetRadioLevel.html">WDGetRadioLevel</a><br> <a href="WDElementID.html">WDElementID</a><br></CODE>
122</p>
123
124<h2>Revision History</h2>
125<p>
126	2006/12/12 Added description.<br>2006/11/09 Initial version.
127</p>
128<hr><p>CONFIDENTIAL</p></body>
129</html>
130