OID_WDI_TASK_CONNECT (dot11wificxintf.h)

Importante

Questo argomento fa parte del modello di driver WiFiCx. WiFiCx è il modello di driver Wi-Fi rilasciato in Windows 11. Ti consigliamo di usare WiFiCx per sfruttare le funzionalità più recenti. Il modello di driver Wi-Fi precedente WDI è in modalità di manutenzione e riceverà solo correzioni ad alta priorità.

OID_WDI_TASK_CONNECT richiede che il componente IHV si connetta a un punto di accesso o a un Wi-Fi Direct GO.

Object	Interruzione in grado di eseguire l'interruzione	Priorità predefinita (criteri driver host)	Tempo di esecuzione normale (secondi)
Porta	Sì. L'interruzione deve essere seguita da una reimpostazione dot11.	4	10

Nell'ambito della connessione, il componente IHV deve eseguire la sincronizzazione, l'autenticazione e l'associazione al servizio BSS. L'host fornisce le voci BSS a cui il componente IHV può tentare di connettersi. Una volta connesso correttamente il componente IHV a una di queste voci, dovrebbe completare il processo di connessione. Se non è in grado di connettersi a una delle voci BSS, deve completare il processo di connessione con un errore.

Il componente IHV non deve eseguire un'analisi per trovare le voci BSS candidate. Può usare l'elenco fornito dall'host per la connessione. Può tentare di connettersi a ognuno, uno dopo l'altro. L'host ordina le reti in base a RSSI, ma il componente IHV può usare il proprio ordine per la connessione. Se l'adattatore non specifica "Connessione override selezione BSS", deve usare solo le voci fornite dall'host per la connessione. L'host può emettere un'interruzione in una connessione in sospeso. Quando si riceve l'interruzione, la porta deve terminare i tentativi di connessione e segnalare un completamento all'host.

Se l'adattatore specifica "Connessione override selezione BSS", può eseguire analisi autonomamente per trovare le voci BSS candidate. Può connettersi a qualsiasi voce BSS trovata purché soddisfi i parametri configurati dall'host. È consigliabile ottimizzare questa selezione per assicurarsi che soddisfi i requisiti di qualità della connessione configurati. Ciò può includere l'ottimizzazione dell'analisi del roaming, l'ottimizzazione della selezione delle API, l'ottimizzazione del processo di associazione e la riduzione al minimo dell'handshake di sicurezza necessario. Durante un'analisi, se il dispositivo necessita di parametri di associazione aggiuntivi per una voce BSS trovata (ad esempio, PMKID per il roaming), può inviare un'indicazione NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST per ottenere i parametri. Se disponibile, l'host configura questi parametri con OID_WDI_edizione Standard T_ASSOCIATION_PARAMETERS.

Se la connessione non riesce o viene interrotta, la porta non deve reimpostare le impostazioni che potrebbero essere state configurate all'esterno del comando connect. Deve supportare l'host che esegue una seconda chiamata di connessione sulla stessa porta.

Lo stato del tentativo di connessione per ogni voce BSS deve essere segnalato dalla porta alla fine del tentativo di associazione. Questo include il tentativo riuscito e anche eventuali tentativi non riusciti. In qualsiasi momento, la porta deve essere associata a non più di un punto di accesso o Wi-Fi Direct GO.

Mentre una connessione è in corso, la porta deve mantenere tutte le connessioni stabilite su altre porte (ad esempio, Infrastruttura o Wi-Fi Direct). Tuttavia, la porta può ridurre la quantità di accesso medio fornito alle altre porte per completare la connessione. Durante la connessione, l'host può inviare richieste di invio di pacchetti su altre porte.

Se l'algoritmo di autenticazione usato per la connessione richiede l'autorizzazione della porta 802.1x per l'accesso alla rete, l'host autorizza la porta al termine dell'operazione di associazione.

La stazione 802.11 usa la cache PMKID per la preautenticazione per i punti di accesso che hanno abilitato l'algoritmo di autenticazione RSNA (Robust Security Network Association). Se la stazione 802.11 è associata o riassociata a un BSSID con un PMKID fornito, la stazione 802.11 deve utilizzare i dati PMKID nell'elemento di informazioni RSN (RSN IE) del frame association o reassociation.

Se la porta dichiara il supporto per la modalità FIPS host in WIFI_STATION_CAPABILITIES, HostFIPSModeEnabled può essere impostato su 1 nei parametri di connessione.

Se HostFIPSModeEnabled è impostato su 1, si applicano le regole seguenti.

• La porta deve seguire le linee guida per l'invio o la ricezione di frame di dati nelle operazioni di invio in modalità FIPS e ricezione in modalità FIPS.
• La porta non deve dichiarare il supporto per qualsiasi protocollo QoS nella richiesta di associazione inviata a un punto di accesso non HT. Il supporto QoS è necessario per le connessioni HT.
• La porta non deve negoziare TSpec e non deve eseguire l'aggregazione MSDU di trasmissione.
• La porta deve garantire che il bit con supporto SPP A-MSDU (bit 10) delle funzionalità RSN che trasmette sia impostato su zero. In questa modalità sono supportati solo PP A-MSDU.

I parametri di connessione non devono avere MFPEnabled e HostFIPSModeEnabled entrambi impostati su 1. La protezione dei frame di gestione (802.11w) richiede la porta per crittografare/decrittografare determinati frame di gestione e azione, quindi non può essere abilitata per una connessione tramite la modalità FIPS host. Inoltre, le funzionalità di riattivazione LAN wireless non sono applicabili in modalità Host-FIPS.

Requisiti wi-fi 7/MLO

Windows fornisce l'impostazione Mlo Connessione ionSupported in WDI_TLV_CONNECTION_edizione Standard TTINGS che indica se il driver può connettersi tramite MLO. Quando si esegue la connessione a una rete sicura, il driver può usare solo le coppie AKM e di crittografia specificate in WDI_TLV_RSNA_AKM_CIPHER_SUITE. L'unica eccezione è se l'autenticazione/crittografia non fa parte di RSNA IE.

Per altre informazioni, vedere Requisiti delle funzionalità Wi-Fi 7 Wi-Fi 7.

Parametri dell'attività

TLV	Sono consentite più istanze TLV	Facoltativo	Descrizione
WDI_TLV_CONNECT_PARAMETERS			Parametri di connessione.
WDI_TLV_CONNECT_BSS_ENTRY	X		Elenco preferito di voci BSS di connessione candidata. La porta deve tentare di connettersi a una di queste voci BSS fino a quando l'elenco non viene esaurito o la connessione è stata completata correttamente. La porta può riscrivere le voci, se necessario. Se l'adattatore ha impostato il bit di override di Connessione selezione BSS BSS, può selezionare un BSS non incluso nell'elenco purché se segue l'elenco Consentito/Non consentito.

Indicazione di completamento attività

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Indicazione non richiesta

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_N edizione Enterprise DED

Requisiti

Requisito	Valore
Client minimo supportato	Windows 11
Server minimo supportato	Windows Server 2022
Intestazione	dot11wificxintf.h