通过

OID_WDI_TASK_CONNECT (dot11wificxintf.h)

  • 项目

重要

本主题是 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。

任务完成指示

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

未经请求的指示

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

要求

要求 值
最低受支持的客户端 Windows 11
最低受支持的服务器 Windows Server 2022
头文件 dot11wificxintf.h