DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 结构 (windot11.h)
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。
UnicastCipher
802.11 工作站在关联操作期间与对等站解析的单播密码算法。 有关 UnicastCipher 成员的数据类型的详细信息，请参阅 DOT11_CIPHER_ALGORITHM。
MulticastCipher
802.11 工作站在关联操作期间与 AP 或对等站解析的多播密码算法。 有关 多播密码 成员的数据类型的详细信息，请参阅 DOT11_CIPHER_ALGORITHM。
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 列表中唯一的条目。
uActivePhyListSize
活动 PHY 列表的长度（以字节为单位）。 uActivePhyListSize 成员必须是 的倍数sizeof(ULONG)。
uBeaconOffset
上次传输的 802.11 信标帧的偏移量（以字节为单位）。
信标帧包括信标帧标头和所有信息元素 (IDE) ，但它不包括 802.11 MAC 标头。 信标帧格式在 ISO/IEC 8802-11 中定义。
信标帧应该是驱动程序使用的最新帧，但实时参数或因数据帧流控制而变化的 IE 或客户端关联状态（如时间戳、无线电参数、TIM、ERP 和 HT IE）不需要准确，
uBeaconSize
上次传输的 802.11 信标帧的长度（以字节为单位）。
信标帧包括信标帧标头和所有信息元素 (IDE) ，但它不包括 802.11 MAC 标头。 信标帧格式在 ISO/IEC 8802-11 中定义。
信标帧应该是驱动程序使用的最新帧，但实时参数或因数据帧流控制而变化的 IE 或客户端关联状态（如时间戳、无线电参数、TIM、ERP 和 HT IE）不需要准确，
注解
本机 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 框架无关的故障。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows 7 及更高版本的 Windows 操作系统。 |
| 标头 | windot11.h (包括 Ndis.h) |