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 同步處理、驗證和關聯。 主機會提供 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 資訊元素 （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 模式來啟用連線。 此外，無線局域網路喚醒功能不適用於主機-FIPS 模式。
WiFi 7 / MLO 需求
Windows 會在 WDI_TLV_CONNECTION_SETTINGS 中提供 Mlo 連線 ionSupported 設定，指出驅動程式是否可以使用 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 |