OID_WDI_TASK_CONNECT (dot11wificxintf.h)

项目
06/27/2024

重要

本主题是 WiFiCx 驱动程序模型的一部分。 WiFiCx 是在 Windows 11 中发布的 Wi-Fi 驱动程序模型。我们建议您使用 WiFiCx 来利用最新功能。以前的 Wi-Fi 驱动程序模型 WDI 处于维护模式，仅接收高优先级修复。

OID_WDI_TASK_CONNECT 请求 IHV 组件连接到访问点或 Wi-Fi Direct GO。

Object	支持中止	默认优先级（主机驱动程序策略）	正常执行时间（秒）
端口	是的。必须在中止后进行 dot11 重置。	4	10

在连接过程中，IHV 组件必须与 BSS 同步、向 BSS 进行身份验证和关联到 BSS。主机提供 IHV 组件可以尝试连接到的 BSS 条目。 IHV 组件成功连接到其中一个条目后，应完成连接进程。如果无法连接到任何 BSS 条目，则应完成连接进程但失败。

IHV 组件不需要执行扫描来查找候选 BSS 条目。它可以使用主机提供用于连接的列表。它可以尝试逐个连接到每个条目。主机按 RSSI 对网络进行排序，但 IHV 组件可以使用自己的连接顺序。如果适配器未指定“连接 BSS 选择替代”，则它只能使用主机提供用于连接的条目。主机可能会在未完成连接上发出中止。收到中止时，端口必须结束连接尝试，并向主机报告完成情况。

如果适配器指定“连接 BSS 选择替代”，它可以自行执行扫描来查找候选 BSS 条目。只要它满足主机配置的参数，就可以连接到找到的任何 BSS 条目。它应优化此选择，以确保满足任何配置的连接质量要求。这可能包括优化漫游扫描、优化 AP 选择、优化关联进程，以及最大程度地减少所需的安全握手。在扫描期间，如果设备需要所找到 BSS 条目（例如用于漫游的 PMKID）的附加关联参数，它可以发送 NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST 指示来获取参数。当可用时，主机将使用 OID_WDI_SET_ASSOCIATION_PARAMETERS 配置这些参数。

如果连接失败或被中止，则端口不能重置可能在连接命令外部配置的任何设置。它必须支持主机在同一端口上发出第二个连接调用。

每个 BSS 条目的连接尝试的状态均必须由端口在关联尝试结束时报告。这包括成功的尝试以及任何失败的尝试。在任何时候，端口均不得与多个访问点或 Wi-Fi Direct GO 相关联。

正在进行连接时，端口必须维护在其他端口（例如基础结构或 Wi-Fi Direct）上建立的任何连接。但是，端口可能会减少提供给其他端口来完成连接的介质访问量。在连接期间，主机可以在其他端口上提交数据包发送请求。

如果用于连接的身份验证算法需要 802.1x 端口授权才能进行网络访问，则主机会在关联操作成功完成后授权该端口。

802.11 工作站使用 PMKID 缓存进行预身份验证，以便访问已启用可靠安全网络关联 (RSNA) 身份验证算法的访问点。如果 802.11 工作站正在关联或重新关联到具有提供的 PMKID 的 BSSID，则 802.11 工作站必须使用其关联或重新关联帧的 RSN 信息元素 (RSN IE) 中的 PMKID 数据。

如果端口在 WIFI_STATION_CAPABILITIES 中声明了对主机 FIPS 模式的支持，则可能会将连接参数中的 HostFIPSModeEnabled 设置为 1。

如果将 HostFIPSModeEnabled 设置为 1，则适用以下规则。

该端口必须遵循在发送操作中以 FIPS 模式和在接收操作中以 FIPS 模式发送/接收数据帧的指南。
该端口不得在发送到非 HT 访问点的关联请求中声明对任何 QoS 协议的支持。 HT 连接需要 QoS 支持。
端口不得协商 TSpec，并且不能执行传输 MSDU 聚合。
该端口必须确保将其传输的 RSN 功能 IE 的支持 SPP A-MSDU 的位（位 10）设置为零。此模式仅支持 PP A-MSDU。

连接参数不能将 MFPEnabled 和 HostFIPSModeEnabled 都设置为 1。管理帧保护 (802.11w) 要求端口加密/解密某些管理和操作帧，以便无法使用主机 FIPS 模式针对连接将其启用。此外，无线 LAN 唤醒功能不适用于主机-FIPS 模式。

WiFi 7/MLO 要求

Windows 在 WDI_TLV_CONNECTION_SETTINGS 中提供 MloConnectionSupported 设置，用于指示驱动程序是否可以使用 MLO 进行连接。连接到安全网络时，驱动程序只能使用在 WDI_TLV_RSNA_AKM_CIPHER_SUITE 中指定的 AKM 和密码对。唯一的例外是验证/密码不是 RSNA IE 的一部分。

有关详细信息，请参阅 WiFiCx Wi-Fi 7 功能要求。

任务参数

TLV	允许多个 TLV 实例	可选	说明
WDI_TLV_CONNECT_PARAMETERS			连接参数。
WDI_TLV_CONNECT_BSS_ENTRY	X		候选连接 BSS 条目的首选列表。端口应尝试连接到其中任何 BSS 条目，直到列表已耗尽或连接已成功完成。如果需要，端口可以重新确定条目的优先级。如果适配器已设置连接 BSS 选择替代位，则只要它遵循“允许/禁止”列表，就可以选取不在此列表中的 BSS。