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 的请求。

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

在连接过程中，IHV 组件必须与 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配置这些参数。

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

在关联尝试结束时，端口必须报告每个 BSS 条目的连接尝试状态。 这包括成功的尝试和任何失败的尝试。 在任何时候，该端口都必须与不超过一个接入点相关联，或者Wi-Fi Direct GO。

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

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

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

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

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

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

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

任务参数

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