共用方式為

OID_WDI_TASK_CONNECT

  • 發行項

重要

本主題是 Windows 10 中發行的WDI 驅動程式模型一部分。 WDI 驅動程式模型處於維護模式，而且只會收到高優先順序修正。 WiFiCx是在 Windows 11 中發行的Wi-Fi驅動程式模型。 建議您使用 WiFiCx 來利用最新的功能。

OID_WDI_TASK_CONNECT要求 IHV 元件連線到存取點或Wi-Fi Direct GO。

Object 支援中止 主機驅動程式原則 (預設優先順序) 正常執行時間 (秒)
連接埠 是的。 中止後面必須加上 dot11 重設。 4 10

在連線過程中，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直接 GO。

進行連線時，埠必須維護在其他 (埠上建立的任何連線，例如基礎結構或Wi-Fi直接) 。 不過，埠可能會減少提供給其他埠的媒體存取量，以完成連線。 在連線期間，主機可以在其他埠提交封包傳送要求。

如果用於連線的驗證演算法需要 802.1x 埠授權以進行網路存取，主機會在關聯作業成功完成之後授權埠。

802.11 月臺使用 PMKID 快取進行預先驗證，以存取已啟用強固安全性網路關聯 (RSNA) 驗證演算法的存取點。 如果 802.11 月臺與具有所提供 PMKID 的 BSSID 產生關聯或重新關聯，802.11 月臺必須使用 RSN 資訊元素中的 PMKID 資料， (RSN IE) 其關聯或重新關聯框架。

如果埠在 WDI_TLV_STATION_ATTRIBUTES中宣告主機 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 模式啟用連線。 此外，網路喚醒功能不適用於主機-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 10

最低支援的伺服器

Windows Server 2016

標頭

 Dot11wdi.h