OID_WDI_TASK_CONNECT （dot11wificxintf.h）

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

在连接过程中，IHV 组件必须与 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 直接）。 但是，端口可能会减少提供给其他端口的中等访问量，以完成连接。 在连接期间，主机可以在其他端口上提交数据包发送请求。

如果用于连接的身份验证算法需要 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 唤醒功能不适用于 Host-FIPS 模式。

WiFi 7/MLO 要求

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

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

任务参数

任务完成指示

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

未经请求的指示

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

要求