windot11.h) (DOT11_SCAN_REQUEST_V2 结构
DOT11_SCAN_REQUEST_V2 结构定义 802.11 工作站执行的显式扫描操作的参数。 工作站在 OID 集请求 OID_DOT11_SCAN_REQUEST后执行显式扫描操作。
语法
typedef struct _DOT11_SCAN_REQUEST_V2 {
DOT11_BSS_TYPE dot11BSSType;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_SCAN_TYPE dot11ScanType;
BOOLEAN bRestrictedScan;
ULONG udot11SSIDsOffset;
ULONG uNumOfdot11SSIDs;
BOOLEAN bUseRequestIE;
ULONG uRequestIDsOffset;
ULONG uNumOfRequestIDs;
ULONG uPhyTypeInfosOffset;
ULONG uNumOfPhyTypeInfos;
ULONG uIEsOffset;
ULONG uIEsLength;
UCHAR ucBuffer[1];
} DOT11_SCAN_REQUEST_V2, *PDOT11_SCAN_REQUEST_V2;
成员
dot11BSSType
(802.11 工作站扫描的 BSS) 网络的基本服务集的类型。 此成员的数据类型是 DOT11_BSS_TYPE 枚举。
dot11BSSID
BSS 标识符 (802.11 工作站扫描的 BSS 网络 BSSID) 。 如果此成员设置为通配符 BSSID (0xFFFFFFFFFFFF) ，则工作站将扫描所有 BSSID。
dot11ScanType
802.11 工作站执行的扫描类型。 此成员的数据类型是声明以下值的 DOT11_SCAN_TYPE 枚举：
dot11_scan_type_active
工作站在扫描的每个通道上传输 802.11 探测请求帧。 它停留在通道上足够长的时间，可以接收其探测请求的 802.11 探测响应帧。 该站还接收通道上发送的 802.11 信标帧。
dot11_scan_type_passive
工作站不会在扫描的每个通道上传输 802.11 探测请求帧。 而是接收通道上发送的 802.11 信标或探测请求帧。
dot11_scan_type_auto
工作站可以执行主动或被动扫描，也可以结合使用这两种扫描类型。
无论 dot11ScanType 的值如何，802.11 工作站在当前监管域中无效的通道上进行扫描时，都必须执行 dot11_scan_type_passive 扫描类型。 此外，如果 802.11 工作站没有默认的监管域，则必须执行 dot11_scan_type_passive 扫描类型。 有关法规域的详细信息，请参阅 OID_DOT11_CURRENT_REG_DOMAIN。
如果在 dot11ScanType 成员中设置了dot11_scan_type_forced位，则 802.11 工作站必须在每个受支持的通道上执行完全扫描。 如果未设置 dot11_scan_type_forced 位，802.11 工作站可以执行完整扫描，也可以对支持的通道的子集执行部分扫描。
bRestrictedScan
如果此成员为 TRUE，则 802.11 工作站将执行仅限于用于连接到 BSS 网络的通道和 PHY 配置的扫描。
如果满足以下任一条件，微型端口驱动程序必须忽略此成员：
- 微型端口驱动程序在 ExtSTA 模式下运行。
- 802.11 工作站未连接到 BSS 网络。
udot11SSIDsOffset
ucBuffer 数组中服务集标识符 (SSID) 列表开始的偏移量。 SSID 列表中的每个条目的格式设置为 DOT11_SSID 结构。
802.11 工作站扫描列表中的每个 SSID。 例如，如果 dot11ScanType 设置为 dot11_scan_type_active，则 802.11 工作站在通道上扫描时，会针对列表中的每个 SSID 传输 802.11 探测请求。
uNumOfdot11SSIDs
SSID 列表中的条目数。
如果 uNumOfdot11SSSIDs 为零，则微型端口驱动程序必须使用包含通配符零长度 SSID 的 SSID 列表。
bUseRequestIE
如果此成员为 TRUE，则 802.11 工作站必须包含通过 uRequestIDsOffset 和 uNumOfRequestIDs 成员) 在 802.11d 请求信息元素 (IE) 在主动扫描期间传输的每个探测请求帧) 定义的请求 ID (列表。
如果满足以下任一条件，微型端口驱动程序必须忽略此成员 (以及 uRequestIDsOffset 和 uNumOfRequestIDs 成员) ：
- 微型端口驱动程序在 ExtSTA 模式下运行。
- 802.11 dot1MultiDomainCapabilityEnabled 管理信息库 (MIB) 对象为 FALSE。 有关 dot11MultiDomainCapabilityEnabled MIB 对象的详细信息，请参阅 OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED。
- dot11ScanType 成员设置为dot11_scan_type_passive。
uRequestIDsOffset
请求 ID 列表开始位置的 ucBuffer 数组中的偏移量。 请求 ID 列表中的每个条目的格式设置为 UCHAR 数据类型。
uNumOfRequestIDs
请求 ID 列表中的条目数。
uPhyTypeInfosOffset
ucBuffer 数组中 PHY 类型列表开始的偏移量。 PHY 类型列表中的每个条目的格式设置为 DOT11_PHY_TYPE_INFO 结构。
802.11 工作站必须使用此列表中的每个指定的 PHY 类型执行 BSS 扫描。
如果 bRestrictedScan 设置为 TRUE，微型端口驱动程序必须忽略此成员 (以及 uNumOfPhyTypeInfos 成员) 。
uNumOfPhyTypeInfos
PHY 类型列表中的条目数。
如果 uNumOfPhyTypeInfos 为零，则 802.11 工作站使用其所有受支持的 PHY 执行扫描。
uIEsOffset
ucBuffer 数组中可变长度信息元素列表 (UCBuffer) 开始的偏移量。 802.11 工作站必须将 IDE 列表追加到它在活动扫描期间传输的每个探测请求帧的末尾。
如果 dot11ScanType 设置为 dot11_scan_type_passive，微型端口驱动程序必须忽略此成员 (以及 uIEsLength 成员 ) 。
uIEsLength
IDE 列表的长度（以字节为单位）。
ucBuffer[1]
包含通过此结构的其他成员指定的可选数据的缓冲区。
注解
802.11 工作站在 OID_DOT11_SCAN_REQUEST的 OID 集请求后执行显式扫描操作。 工作站使用通过DOT11_SCAN_REQUEST_V2定义的参数执行扫描操作，该参数与设置请求一起提供。
有关 Native 802.11 微型端口驱动程序执行的扫描操作的详细信息，请参阅 本机 802.11 扫描操作。
有关 ExtSTA 操作模式的详细信息，请参阅 可扩展工作站操作模式。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
| 标头 | windot11.h (包括 Ndis.h) |