Partager via


OID_WDI_TASK_CONNECT

Important

Cette rubrique fait partie du modèle de pilote WDI publié dans Windows 10. Le modèle de pilote WDI est en mode maintenance et ne reçoit que des correctifs de priorité élevée. WiFiCx est le modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.

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

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

Dans le cadre de la connexion, le composant IHV doit se synchroniser avec, s’authentifier auprès du BSS et l’associer. L’hôte fournit les entrées BSS auxquelles le composant IHV peut tenter de se connecter. Une fois que le composant IHV s’est correctement connecté à 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 BSS, il doit terminer le processus de connexion avec un échec.

Le composant IHV n’a pas besoin d’effectuer une analyse pour rechercher 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’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 « Remplacer la sélection BSS de connexion », il doit uniquement utiliser les entrées fournies par l’hôte pour la connexion. L’hôte peut émettre un abandon sur une connexion en attente. À la réception de l’abandon, le port doit mettre fin aux tentatives de connexion et signaler une fin à l’hôte.

Si l’adaptateur spécifie « Remplacer la sélection BSS de connexion », il peut effectuer des analyses par lui-même pour rechercher 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 à toutes les exigences de qualité de connexion configurées. Cela peut inclure l’optimisation de l’analyse itinérante, l’optimisation de la sélection des AP, l’optimisation du processus d’association et la réduction de la négociation de sécurité nécessaire. Lors 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’il est disponible, l’hôte configure ces paramètres avec OID_WDI_SET_ASSOCIATION_PARAMETERS.

Si la connexion échoue ou est abandonnée, le port ne doit pas réinitialiser les paramètres qui peuvent avoir été configurés en dehors de la commande connect. Il doit prendre en charge l’hôte qui émet un deuxième appel de connexion sur le même port.

Le status 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 toutes les tentatives ayant échoué. À tout moment, le port ne doit pas être associé à plusieurs points d’accès ou Wi-Fi Direct GO.

Pendant qu’une connexion est en cours, le port doit conserver 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 fourni aux autres ports pour terminer la connexion. Pendant la connexion, l’hôte peut envoyer des demandes d’envoi de paquets sur d’autres ports.

Si l’algorithme d’authentification utilisé pour la connexion nécessite une autorisation de port 802.1x pour l’accès réseau, l’hôte autorise le port une fois l’opération d’association terminée.

La station 802.11 utilise le cache PMKID pour la pré-authentification pour accéder aux points d’accès qui ont activé l’algorithme d’authentification RSNA (Robust Security Network Association). Si la station 802.11 associe ou s’associe à un BSSID qui a un PMKID fourni, la station 802.11 doit utiliser les données PMKID dans l’élément d’information RSN (RSN IE) de son cadre d’association ou de réassociation.

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

Si HostFIPSModeEnabled a la valeur 1, les règles suivantes s’appliquent.

  • Le port doit suivre les instructions relatives à l’envoi/réception de trames de données dans Envoyer des opérations 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 demande d’association envoyée à un point d’accès non-HT. La prise en charge de QoS est requise pour les connexions HT.
  • Le port ne doit pas négocier TSpec et ne doit pas effectuer l’agrégation MSDU de transmission.
  • Le port doit s’assurer que le bit compatible SPP A-MSDU (bit 10) des fonctionnalités RSN qu’il transmet est défini sur zéro. Seul PP A-MSDU est pris en charge dans ce mode.

Les paramètres de connexion ne doivent pas avoir MFPEnabled et HostFIPSModeEnabled définis sur 1. La protection des cadres de gestion (802.11w) nécessite que le port chiffre/déchiffre certaines trames de gestion et d’action, de sorte qu’il ne peut pas être activé pour une connexion à l’aide du mode FIPS hôte. En outre, les fonctionnalités Wake on Wireless LAN ne s’appliquent pas en mode Host-FIPS.

Paramètres de tâche

TLV Plusieurs instances TLV autorisées Facultatif Description
WDI_TLV_CONNECT_PARAMETERS Paramètres de connexion.
WDI_TLV_CONNECT_BSS_ENTRY X Liste préférée des entrées BSS de connexion candidate. Le port doit tenter de se connecter à l’une de ces entrées BSS jusqu’à ce que la liste soit épuisée ou que la connexion soit terminée. Le port peut redimensionnaliser les entrées si nécessaire. Si l’adaptateur a défini le bit De remplacement de la sélection BSS de connexion, il peut choisir un BSS qui ne figure pas dans cette liste tant qu’il suit la liste Autorisé/non autorisé.

Indication de fin de 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

Configuration requise

Client minimal pris en charge

Windows 10

Serveur minimal pris en charge

Windows Server 2016

En-tête

Dot11wdi.h