windot11.h) (DOT11_SCAN_REQUEST_V2 结构

  • 项目
重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

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 工作站可以执行完整扫描，也可以对支持的通道的子集执行部分扫描。

注意仅当微型端口驱动程序在 Extensible Station (ExtSTA) 模式下运行时，才支持dot11_scan_type_forced位。 必须通过具有 DOT11_SCAN_TYPE 值的按位 OR 设置dot11_scan_type_forced位。

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)

另请参阅

DOT11_PHY_TYPE_INFO

OID_DOT11_SCAN_REQUEST