DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 结构 (windot11.h)

项目
03/05/2024

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

DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 结构指定 802.11 工作站在收到来自基础结构 BSS 上的对等站的关联请求后执行的关联操作的结果。

语法

typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  DOT11_MAC_ADDRESS      PeerMacAddr;
  ULONG                  uStatus;
  UCHAR                  ucErrorSource;
  BOOLEAN                bReAssocReq;
  BOOLEAN                bReAssocResp;
  ULONG                  uAssocReqOffset;
  ULONG                  uAssocReqSize;
  ULONG                  uAssocRespOffset;
  ULONG                  uAssocRespSize;
  DOT11_AUTH_ALGORITHM   AuthAlgo;
  DOT11_CIPHER_ALGORITHM UnicastCipher;
  DOT11_CIPHER_ALGORITHM MulticastCipher;
  ULONG                  uActivePhyListOffset;
  ULONG                  uActivePhyListSize;
  ULONG                  uBeaconOffset;
  ULONG                  uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;

成员

Header

DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将 Header 的成员设置为以下值：

类型

此成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。

修订

此成员必须设置为 DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1。

大小

此成员必须设置为 sizeof (DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS) 。

有关这些成员的详细信息，请参阅 NDIS_OBJECT_HEADER。

PeerMacAddr

媒体访问控制 (MAC) 发送关联请求的对等站的地址。

uStatus

与对等站的关联状态。如果为零，则关联成功。如果不是零，则关联失败。

ucErrorSource

对于 uStatus 的非零值，此成员指示阻止关联的错误的来源。 NIC 必须将 ucErrorSource 设置为以下值之一：

DOT11_ASSOC_ERROR_SOURCE_OS

微型端口驱动程序由于系统错误（例如内存不足错误）拒绝了关联过程。在这种情况下，应将 uStatus 设置为从操作系统返回的NDIS_STATUS_XXX或NTSTATUS_XXX代码。

DOT11_ASSOC_ERROR_SOURCE_REMOTE

AP 或对等站已拒绝关联过程。在这种情况下， uStatus 应设置为 802.11 身份验证帧、关联响应帧或重新关联响应帧中的 802.11 状态代码。 IEEE 802.11-2003 规范中的表 19 包含所有可能的值。修改后，微型端口驱动程序还可以返回此 IEEE 规范中的新值。

DOT11_ASSOC_ERROR_SOURCE_OTHER

关联因特定于 IHV 的原因而失败。在本例中， uStatus 包含由 IHV 指定的非零值。

bReAssocReq

一个布尔值，该值指示来自对等站的请求是否为重新关联请求。

bReAssocResp

一个布尔值，指示来自 NIC 的响应是否为重新关联请求。

uAssocReqOffset

关联操作中使用的请求帧的偏移量。该帧包含信息元素 (IDE) 但不包括 802.11 MAC 标头。

uAssocReqSize

关联操作中使用的请求帧的长度（以字节为单位）。该帧包含信息元素 (IDE) 但不包括 802.11 MAC 标头。

uAssocRespOffset

关联操作中使用的响应帧的偏移量。该帧包含信息元素 (IDE) 但不包括 802.11 MAC 标头。

uAssocRespSize

关联操作中使用的响应帧的长度（以字节为单位）。该帧包含信息元素 (IDE) 但不包括 802.11 MAC 标头。

AuthAlgo

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

注意如果 uStatus 未设置为零，微型端口驱动程序必须将此成员设置为零。

UnicastCipher

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

注意如果 uStatus 未设置为零，微型端口驱动程序必须将此成员设置为零。

MulticastCipher

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

注意如果 uStatus 未设置为零，微型端口驱动程序必须将此成员设置为零。

uActivePhyListOffset

PHY 标识符列表 (ID 的偏移量) 802.11 工作站用于在 BSS 网络连接上发送或接收数据包。每个条目都是一个 ULONG 值。

Extensible Station (ExtSTA) msDot11ActivePhyList MIB objec 也引用活动 PHY 列表。

活动 PHY 列表中的条目可以是以下值之一：

由 Extensible Station (ExtSTA) msDot11DesiredPhyList 管理信息库 (MIB) 对象指定的 PHY ID。有关此 MIB 对象的详细信息，请参阅 OID_DOT11_DESIRED_PHY_LIST。
DOT11_PHY_ID_ANY的 PHY ID。如果 ExtSTA msDot11ActivePhyList MIB 对象指定由 msDot11DesiredPhyList MIB 对象指定的所有 PHY ID，微型端口驱动程序可以设置此值的条目。有关此 MIB 对象的详细信息，请参阅 OID_DOT11_ACTIVE_PHY_LIST。
注意值为 DOT11_PHY_ID_ANY 的条目必须是活动 PHY 列表中唯一的条目。

活动 PHY 列表的偏移量相对于包含 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 结构的缓冲区的起始位置。

注意如果 uStatus 未设置为零，微型端口驱动程序必须将此成员设置为零。

uActivePhyListSize

活动 PHY 列表的长度（以字节为单位）。 uActivePhyListSize 成员必须是的倍数sizeof(ULONG)。

注意如果 uStatus 未设置为零，微型端口驱动程序必须将此成员设置为零。

uBeaconOffset

上次传输的 802.11 信标帧的偏移量（以字节为单位）。

信标帧包括信标帧标头和所有信息元素 (IDE) ，但它不包括 802.11 MAC 标头。信标帧格式在 ISO/IEC 8802-11 中定义。

信标帧应该是驱动程序使用的最新帧，但实时参数或因数据帧流控制而变化的 IE 或客户端关联状态（如时间戳、无线电参数、TIM、ERP 和 HT IE）不需要准确，

注意如果 uStatus 未设置为零，微型端口驱动程序必须将此成员设置为零。

uBeaconSize

上次传输的 802.11 信标帧的长度（以字节为单位）。

信标帧包括信标帧标头和所有信息元素 (IDE) ，但它不包括 802.11 MAC 标头。信标帧格式在 ISO/IEC 8802-11 中定义。

注意如果 uStatus 未设置为零，微型端口驱动程序必须将此成员设置为零。

注解

本机 802.11 微型端口驱动程序包含DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS结构（当驱动程序生成时） NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION 状态指示。

NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION状态指示标记 关联指示块的结束。如果关联成功，则 NIC 必须在成功将相应的关联响应帧发送到最初请求关联的工作站后发出NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION指示。如果关联失败，NIC 必须发出NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION指示响应是否成功发送。失败可能是因为 NIC 或操作系统拒绝关联请求，或者由于与 802.11 框架无关的故障。