Partager via

OID_WDI_TASK_DOT11_RESET (dot11wificxintf.h)

  • Article

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_DOT11_RESET demande au composant IHV de réinitialiser l'état MAC et PHY sur un port spécifié.

Object Possibilité d'abandon 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 dot11 reset, le pilote WDI arrête d'émettre de nouvelles commandes au 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 des primitives de réinitialisation 802.11 MLME et PLME. Lorsque le composant IHV reçoit une requête de réinitialisation dot11, il doit effectuer les tâches suivantes.

  • Réinitialiser l'entité MAC du port à son état initial.
  • Réinitialiser les attributs MIB du port pour qu'ils soient réglés sur leurs valeurs par défaut, si bSetDefaultMIB est vrai.
  • Réinitialiser les machines d'état TX/Rx pour l'entité PHY et la mettre à l'état Rx uniquement pour s'assurer qu'aucune autre trame n'est transmise.
  • Vide la file d'attente Rx de l'adaptateur et termine l'envoi de chaque paquet dans les files d'attente TX.
  • Si le paramètre MAC address est présent, réinitialisez l'adresse MAC du port à la valeur spécifiée.
  • Mettez l'état du port sur INIT avant de terminer l'opération de réinitialisation dot11.

Si le port réinitialisé fonctionnait en tant que STA, AP, ou client ou GO Wi-Fi Direct, l'hôte aurait déclenché la tâche de déconnexion pour requérir du composant IHV qu'il envoie la désassociation aux pairs avant la réinitialisation. Le composant IHV n'a donc pas besoin de le faire à nouveau.

Paramètres de tâche

TLV Plusieurs instances TLV autorisées Facultatif Description
WDI_TLV_DOT11_RESET_PARAMETERS Paramètres pour la réinitialisation dot11.
WDI_TLV_CONFIGURED_MAC_ADDRESS X L'adresse MAC à utiliser pour le port.
WDI_TLV_CONFIGURED_MLO_LINK_MAC_ADDRESS X Un tableau d'adresses MAC de liens MLO (Multi-Link Operation).

Indication d'achèvement de la tâche

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

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