windot11.h) (DOT11_PEER_INFO 结构

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息,请参阅 WLAN 通用 Windows 驱动程序模型
 
DOT11_PEER_INFO结构指定有关独立基本服务集 (IBSS) 网络对等站的信息。
注意 IBSS (即席) 和 SoftAP 已弃用。 从 Windows 8.1 和 Windows Server 2012 R2 开始,请使用 Wi-Fi Direct
 

语法

typedef struct _DOT11_PEER_INFO {
  DOT11_MAC_ADDRESS       MacAddress;
  USHORT                  usCapabilityInformation;
  DOT11_AUTH_ALGORITHM    AuthAlgo;
  DOT11_CIPHER_ALGORITHM  UnicastCipherAlgo;
  DOT11_CIPHER_ALGORITHM  MulticastCipherAlgo;
  BOOLEAN                 bWpsEnabled;
  USHORT                  usListenInterval;
  UCHAR                   ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2];
  USHORT                  usAssociationID;
  DOT11_ASSOCIATION_STATE AssociationState;
  DOT11_POWER_MODE        PowerMode;
  LARGE_INTEGER           liAssociationUpTime;
  DOT11_PEER_STATISTICS   Statistics;
} DOT11_PEER_INFO, *PDOT11_PEER_INFO;

成员

MacAddress

媒体访问控制 (MAC) 独立 BSS (IBSS) 网络中对等工作站的地址。

usCapabilityInformation

802.11 工作站最近从对等机接收的信标或探测响应帧中的 802.11 功能信息字段。

AuthAlgo

802.11 工作站在关联操作期间与对等工作站一起解析的身份验证算法。 有关 AuthAlgo 成员的数据类型的详细信息,请参阅 DOT11_AUTH_ALGORITHM

如果未关联对等,则不定义此成员。

UnicastCipherAlgo

802.11 工作站在关联操作期间与对等工作站解析的单播密码算法。 有关 UnicastCipherAlgo 成员的数据类型的详细信息,请参阅 DOT11_CIPHER_ALGORITHM

如果未关联对等,则不定义此成员。

MulticastCipherAlgo

802.11 工作站在关联操作期间与对等工作站解析的多播密码算法。 有关 MulticastCipherAlgo 成员的数据类型的详细信息,请参阅 DOT11_CIPHER_ALGORITHM

如果未关联对等,则不定义此成员。

bWpsEnabled

一个布尔值,指示是否为对等工作站启用 WiFi 保护安装程序 (WPS) 。 如果 为 TRUE,则启用 WPS,并且对等方使用的身份验证和密码算法可能与 AP 上启用的算法不同。

如果未关联对等,则不应使用此成员。

usListenInterval

一个 USHORT 值,该值定义从关联请求获取的“802.11 侦听间隔”字段。

如果未关联对等,则此成员的值为零。

ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2]

一个 UCHAR 值,该值指定对等工作站支持的数据速率。 这些速率基于 802.11 工作站最近从对等机接收的信标或探测响应帧中的 802.11 支持速率 IE。

ucPeerSupportedRates 数组中的每个条目都是通过 查询返回的数据速率表中索引的值 OID_DOT11_DATA_RATE_MAPPING_TABLE。 索引值必须介于 2 和 127 之间。

如果未关联对等,则此成员的值为零。

usAssociationID

一个 USHORT 值,该值指定 802.11 工作站从 AP 接收的关联或重新关联响应帧中的 802.11 关联 ID 字段。

如果未关联对等,则此成员的值为 0xFFFF。

AssociationState

一个 DOT11_ASSOCIATION_STATE 类型的值,指示对等工作站的 802.11 身份验证和关联状态。 状态可以是 dot11_assoc_state_auth_unassocdot11_assoc_state_auth_assoc

IEEE 802.11 标准版中,802.11 身份验证过程对于独立网络是可选的。 因此,根据 IHV 实现, dot11_assoc_state_auth_unassoc 枚举值表示的状态可能不适用。

PowerMode

描述对等工作站的最新电源管理模式的 DOT11_POWER_MODE类型值。

liAssociationUpTime

一个 LARGEINTEGER 值,该值指定 802.11 关联过程成功完成时的时间戳。 微型端口驱动程序调用 NdisGetCurrentSystemTime 以获取关联完成的时间戳。

如果未关联对等,则此成员的值为零。

Statistics

数据流量的统计信息计数器,由 DOT11_PEER_STATISTICS 结构定义。

如果未关联对等,则此成员的值为零。

要求

要求
最低受支持的客户端 在 Windows 7 及更高版本的 Windows 操作系统中可用。
标头 windot11.h (包括 Ndis.h)

另请参阅

DOT11_POWER_MODE

DOT11_ASSOCIATION_STATE

NdisGetCurrentSystemTime

DOT11_PEER_STATISTICS

DOT11_PEER_INFO_LIST

NDIS_OBJECT_HEADER