windot11.h) (DOT11_BSS_ENTRY 结构

项目
02/27/2024

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

DOT11_BSS_ENTRY结构定义 802.11 工作站在其上次扫描操作期间收到的 IEEE 802.11 信标或响应帧。

语法

typedef struct DOT11_BSS_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  BOOLEAN                           bInRegDomain;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBufferLength;
  UCHAR                             ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;

成员

uPhyId

802.11 工作站用于检测 BSS 网络的 PHY 的标识符 (ID) 。 PHY ID 是驱动程序通过查询 OID_DOT11_SUPPORTED_PHY_TYPES返回的受支持 PHY 列表中的索引。

不得DOT11_PHY_ID_ANY此 ID。

PhySpecificInfo

uPhyId 成员引用的 PHY 的属性。 PhySpecificInfo 的格式设置为 DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO 联合。

dot11BSSID

媒体访问控制 (MAC) 地址，该接入点 (AP) (，适用于基础结构 BSS 网络) 或对等站 (的独立 BSS 网络) ，该网络在扫描时发送了 802.11 信号或探测响应帧。此成员的数据类型是 DOT11_MAC_ADDRESS 结构。

dot11BSSType

BSS 网络类型。

此成员的数据类型是 DOT11_BSS_TYPE 枚举。微型端口驱动程序不得将此成员设置为 dot11_BSS_type_any 值。

lRSSI

接收的信号强度指示器 (RSSI) 值，以分贝为单位，引用 1.0 毫瓦 (dBm) ，由 AP 或对等站的 802.11 站检测到。

uLinkQuality

从 0 到 100 的链接质量值。值 100 指定最高的链接质量。有关确定链接质量的详细信息，请参阅链接质量操作。

bInRegDomain

此成员指定 AP 或对等工作站是否在输入国家/地区字符串标识的法规域中运行。若要设置此成员，微型端口驱动程序必须使用以下准则：

如果 802.11 工作站不支持多个监管域，请将成员设置为 TRUE。有关多个法规域的详细信息，请参阅 OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED。
如果输入国家/地区字符串全部为零，请将成员设置为 TRUE。
如果 AP 或对等工作站未在对输入国家/地区字符串指定的监管域有效的通道上运行，请将成员设置为 FALSE。
如果从 AP 或对等工作站接收的 802.11 信标或探测响应帧不包含国家/地区信息元素 (IE) ，请将成员设置为 TRUE。
有关国家/地区 IE 的详细信息，请参阅 IEEE 802.11d-2001 标准的条款 7.3.2.12。
如果从 AP 或对等工作站接收的 802.11 信标或探测响应帧包含国家/地区 IE，则如果“国家/地区字符串”子字段的值不等于输入国家/地区字符串，则将成员设置为 FALSE 。
在所有其他情况下，将成员设置为 TRUE 。