Partager via


OID_WDI_TASK_CONNECT (dot11wificxintf.h)

Important

Cette rubrique fait partie du modèle de pilote WiFiCx. WiFiCx est le modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour exploiter les toutes dernières fonctionnalités. Le modèle de pilote Wi-Fi précédent, WDI, est en mode de maintenance et ne recevra que des correctifs à priorité élevée.

OID_WDI_TASK_CONNECT demande que le composant IHV se connecte à un point d'accès ou à un GO Wi-Fi Direct.

Object Possibilité d'abandon Priorité par défaut (stratégie du pilote hôte) Temps d'exécution normal (secondes)
Port Oui. L'abandon doit être suivi d'une réinitialisation de dot11. 4 10

Dans le cadre de la connexion, le composant IHV doit se synchroniser avec le BSS, s'authentifier auprès de lui et s'y associer. L'hôte fournit les entrées BSS auxquelles le composant IHV peut tenter de se connecter. Une fois que le composant IHV a réussi à se connecter à l'une de ces entrées, il doit terminer le processus de connexion. S'il ne parvient pas à se connecter à l'une des entrées du BSS, il doit terminer le processus de connexion par un échec.

Le composant IHV n'a pas besoin d'analyser les entrées BSS candidates. Il peut utiliser la liste fournie par l'hôte pour la connexion. Il peut tenter de se connecter à chacun d'entre eux, l'un après l'autre. L'hôte trie les réseaux par RSSI, mais le composant IHV peut utiliser son propre ordre de connexion. Si l'adaptateur ne spécifie pas "Connect BSS Selection Override", il ne doit utiliser que les entrées fournies par l'hôte pour la connexion. L'hôte peut demander l'annulation d'une connexion en cours. A la réception de l'annulation, le port doit mettre fin aux tentatives de connexion et signaler à l'hôte que la connexion est terminée.

Si l'adaptateur spécifie "Connect BSS Selection Override", il peut analyser lui-même les entrées BSS candidates. Il peut se connecter à n'importe quelle entrée BSS qu'il trouve tant qu'elle répond aux paramètres configurés par l'hôte. Il doit optimiser cette sélection pour s'assurer qu'elle répond aux exigences de qualité de connexion configurées. Il peut s'agir d'optimiser l'analyse de l'itinérance, d'optimiser la sélection des points d'accès, d'optimiser le processus d'association et de minimiser la liaison de sécurité nécessaire. Au cours d'une analyse, si l'appareil a besoin de paramètres d'association supplémentaires pour une entrée BSS trouvée (par exemple, PMKID pour l'itinérance), il peut envoyer une indication NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST pour obtenir les paramètres. Lorsqu'ils sont disponibles, l'hôte configure ces paramètres avec OID_WDI_SET_ASSOCIATION_PARAMETERS.

Si la connexion échoue ou est interrompue, le port ne doit pas réinitialiser les paramètres qui ont pu être configurés en dehors de la commande de connexion. Il doit permettre à l'hôte d'émettre un second appel de connexion sur le même port.

L'état de la tentative de connexion pour chaque entrée BSS doit être signalé par le port à la fin de la tentative d'association. Cela inclut la tentative réussie ainsi que les tentatives échouées. À tout moment, le port ne doit pas être associé à plus d'un point d'accès ou Wi-Fi Direct GO.

Pendant qu'une connexion est en cours, le port doit maintenir toutes les connexions établies sur d'autres ports (par exemple, Infrastructure ou Wi-Fi Direct). Toutefois, le port peut réduire la quantité d'accès moyen fournie aux autres ports pour terminer la connexion. Pendant la connexion, l'hôte peut soumettre des requêtes d'envoi de paquets sur d'autres ports.

Si l'algorithme d'authentification utilisé pour la connexion requiert l'autorisation du port 802.1x pour l'accès au réseau, l'hôte autorise le port une fois que l'opération d'association s'est achevée avec succès.

La station 802.11 utilise le cache PMKID pour la préauthentification des points d'accès qui ont activé l'algorithme d'authentification RSNA (Robust Security Network Association). Si la station 802.11 s'associe ou se réassocie à un BSSID qui possède un PMKID fourni, elle doit utiliser les données PMKID dans l'élément d'information RSN (RSN IE) de sa trame d'association ou de réassociation.

Si le port déclare la prise en charge du mode Host FIPS dans WIFI_STATION_CAPABILITIES, HostFIPSModeEnabled peut être défini sur 1 dans les paramètres de connexion.

Si HostFIPSModeEnabled est défini sur 1, les règles suivantes s'appliquent.

  • Le port doit respecter les directives relatives à l'envoi/la réception de trames de données dans les sections Opérations d'envoi en mode FIPS et Opérations de réception en mode FIPS.
  • Le port ne doit pas déclarer la prise en charge d'un protocole QoS dans la requête d'association envoyée à un point d'accès non HT. La prise en charge de la qualité de service est requise pour les connexions HT.
  • Le port ne doit pas négocier de TSpec et ne doit pas effectuer d'agrégation de MSDU de transmission.
  • Le port doit s'assurer que le bit SPP A-MSDU capable (bit 10) du RSN capabilities IE qu'il transmet est mis à zéro. Seuls les PP A-MSDU sont pris en charge dans ce mode.

Les paramètres de connexion ne doivent pas avoir MFPEnabled et HostFIPSModeEnabled tous deux réglés sur 1. La protection des trames de gestion (802.11w) exige que le port chiffre/déchiffre certaines trames de gestion et d'action. Elle ne peut donc pas être activée pour une connexion utilisant le mode Host FIPS. En outre, les fonctionnalités Wake on Wireless LAN ne sont pas applicables en mode Host-FIPS.

Configuration requise pour WiFi 7 / MLO

Windows fournit le paramètre MloConnectionSupported dans WDI_TLV_CONNECTION_SETTINGS qui indique si le pilote peut se connecter en utilisant MLO. Lors de la connexion à un réseau sécurisé, le pilote ne peut utiliser que l'AKM et les appaires de chiffrement spécifiés dans WDI_TLV_RSNA_AKM_CIPHER_SUITE. La seule exception est si l’authentification/chiffrement ne fait pas partie de l'élément d'information RSNA.

Pour plus d'informations, voir les exigences des fonctionnalités de WiFiCx Wi-Fi 7.

Paramètres de tâche

TLV Plusieurs instances TLV autorisées Facultatif Description
WDI_TLV_CONNECT_PARAMETERS Les paramètres de connexion.
WDI_TLV_CONNECT_BSS_ENTRY X La liste préférée des entrées BSS de connexion candidates. Le port doit tenter de se connecter à n'importe laquelle de ces entrées BSS jusqu'à ce que la liste soit épuisée ou que la connexion soit terminée avec succès. Le port peut redéfinir l'ordre de priorité des entrées si nécessaire. Si l'adaptateur a activé le bit de remplacement de la sélection du BSS de connexion, il peut choisir un BSS qui n'est pas dans cette liste tant qu'il suit la liste autorisée/désapprouvée.

Indication d'achèvement de la tâche

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Indication non sollicitée

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows 11
Serveur minimal pris en charge Windows Server 2022
En-tête dot11wificxintf.h