Partager via


OID_WDI_TASK_DOT11_RESET

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é en Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.

OID_WDI_TASK_DOT11_RESET demande que le composant IHV réinitialise l’état MAC et PHY sur un port spécifié.

Object Abandonner la capacité Priorité par défaut (stratégie du pilote hôte) Temps d’exécution normal (secondes)
Port Non 1 1

Avant d’émettre une commande de réinitialisation dot11, le pilote WDI arrête d’émettre de nouvelles commandes pour le composant IHV et abandonne toute tâche en cours sur le port. Il vide également ses files d’attente Rx et TX.

La réinitialisation dot11 combine la sémantique de la primitive de réinitialisation MLME et PLME 802.11. Lorsque le composant IHV reçoit une demande de réinitialisation dot11, il doit effectuer les tâches suivantes.

  • Réinitialisez l’entité MAC du port à son état initial.
  • Réinitialisez les attributs MIB du port afin qu’ils soient définis sur leurs valeurs par défaut, si bSetDefaultMIB a la valeur true.
  • Réinitialisez les machines d’état TX/Rx pour l’entité PHY et définissez-la sur l’état Rx uniquement pour vous assurer qu’aucune trame supplémentaire n’est transmise.
  • Videz la file d’attente Rx de l’adaptateur et terminez l’envoi pour chaque paquet dans les files d’attente TX.
  • Si le paramètre d’adresse MAC est présent, réinitialisez l’adresse MAC du port à la valeur spécifiée.
  • Définissez l’état du port sur INIT avant d’effectuer l’opération de réinitialisation dot11.

Si le port réinitialisé fonctionnait en tant que STA, AP ou Wi-Fi Direct Client ou GO, l’hôte aurait déclenché la tâche de déconnexion pour demander au composant IHV d’envoyer la dissociation aux homologues avant la réinitialisation. Par conséquent, le composant IHV n’a pas besoin de le refaire.

Paramètres de tâche

TLV Plusieurs instances TLV autorisées Facultatif Description
WDI_TLV_DOT11_RESET_PARAMETERS Paramètres de la réinitialisation dot11.
WDI_TLV_CONFIGURED_MAC_ADDRESS X Adresse MAC qui doit être utilisée pour le port.

Indication de l’achèvement de la tâche

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

Configuration requise

Client minimal pris en charge

Windows 10

Serveur minimal pris en charge

Windows Server 2016

En-tête

Dot11wdi.h