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>WDScanParam</title>
8</head>
9<body>
10
11<h1>WDScanParam</h1>
12
13<h2>C Specification</h2>
14<dl>
15  <dd><pre><code>#include &lt;revolution/wd/WDApi.h&gt;</code></pre>
16  <dd><pre><code>typedef  struct WDScanParam_  WDScanParam;</code></pre>
17  <dd><pre><code>struct WDScanParam_
18{
19    u16     channelBitmap;
20    u16     maxChannelTime;
21    u8      bssid[6];
22    u16     scanType;
23    u16     ssidLength;
24    u8      ssid[32];
25    u8      ssidMatchMask[32];
26};</code></pre>
27</dl>
28
29<h2>Description</h2>
30<p>
31	A structure type for performing scanning operation settings using the <CODE><a href="WDScanOnce.html">WDScanOnce</a></CODE> function.
32</p>
33<table border="1" cellpadding="3" cellspacing="0.1">
34	<tr>
35		<TH><em>channelBitmap</em></TH>
36		<TD>
37			Specifies the wireless channel list from which to scan in bit field format.<br>Specify from among the available channels that can be obtained with the <CODE><a href="WDCheckEnableChannel.html">WDCheckEnableChannel</a></CODE> function.
38		</TD>
39	</tr>
40	<tr>
41		<TH><em>maxChannelTime</em></TH>
42		<TD>
43			Specifies the time in milliseconds for a scan for a single channel specified in <CODE><strong><em>channelBitmap</em></strong></CODE>.
44		</TD>
45	</tr>
46	<tr>
47		<TH><em>bssid</em></TH>
48		<TD>
49			Specifies the BSSID for a scan.<br>To avoid specifying a BSSID, specify a broadcast ID of <CODE>0xff</CODE> for everything.
50		</TD>
51	</tr>
52	<tr>
53		<TH><em>scanType</em></TH>
54		<TD>
55			Designates the scan type.
56			<table border="1" cellpadding="3" cellspacing="0.1">
57				<tr>
58					<TH>WD_SCANTYPE_ACTIVE</TH>
59					<TD>Active scanning. Issues a probe request and searches for a probe response from the target.</TD>
60				</tr>
61				<tr>
62					<TH>WD_SCANTYPE_PASSIVE</TH>
63					<TD>Passive scanning. Searches for a beacon issued by the target.</TD>
64				</tr>
65			</table>
66		</TD>
67	</tr>
68	<tr>
69		<TH><em>ssidLength</em></TH>
70		<TD>Specifies the size in bytes of the service set (SS) ID specified by <CODE><strong><em>ssid</em></strong></CODE>.</TD>
71	</tr>
72	<tr>
73		<TH><em>ssid</em></TH>
74		<TD>
75			Specifies the SSID for a scan. Does not distinguish either the network uses the extended service set (ESS) or the independent basic service set (IBSS).<br>Also be aware that since the SSID is a byte row, it is not null-terminated.
76		</TD>
77	</tr>
78	<tr>
79		<TH><em>ssidMatchMask</em></TH>
80		<TD>
81			Specifies the bit mask to perform match confirmation for the SSID specified in <CODE><strong><em>ssid</em></strong></CODE> against the SSID found in the scan results. Confirms the <CODE>0</CODE> portions of bits within the 256 bits; <CODE>1</CODE> portions are ignored. To avoid specifying an SSID, specify a mask of <CODE>0xff</CODE> for everything.
82		</TD>
83	</tr>
84</table>
85
86<h2>See Also</h2>
87<p>
88	<CODE><a href="WDScanOnce.html">WDScanOnce</a><br></CODE>
89</p>
90
91<h2>Revision History</h2>
92<p>
93	2006/12/12 Added description.<br>2006/11/09 Initial version.
94</p>
95<hr><p>CONFIDENTIAL</p></body>
96</html>
97