Freigeben über

OID_WDI_TASK_DOT11_RESET (dot11wificxintf.h)

  • Artikel

Wichtig

Dieses Thema ist Teil des WiFiCx-Treibermodells. WiFiCx ist das in Windows 11 veröffentlichte WLAN-Treibermodell. Es wird empfohlen, WiFiCx zu verwenden, um die neuesten Features nutzen zu können. Das vorherige WLAN-Treibermodell WDI befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität.

OID_WDI_TASK_DOT11_RESET fordert an, dass die IHV-Komponente den MAC- und PHY-Zustand auf einem angegebenen Port zurücksetzt.

Objekt Abbruchfähig Standardpriorität (Hosttreiberrichtlinie) Normale Ausführungszeit (Sekunden)
Port No 1 1

Vor dem Ausgeben eines Dot11-Zurücksetzungsbefehls beendet der WDI-Treiber das Ausstellen neuer Befehle an die IHV-Komponente und bricht alle im Anschluss ausgeführten Aufgaben ab. Außerdem werden die Rx- und TX-Warteschlangen geleert.

Das Zurücksetzen von Dot11 kombiniert die Semantik des 802.11 MLME- und PLME-Zurücksetzungsgrundtyps. Wenn die IHV-Komponente eine dot11-Zurücksetzungsanforderung empfängt, sollte sie die folgenden Aufgaben ausführen.

  • Setzen Sie die MAC-Entität des Ports auf den Anfangszustand zurück.
  • Setzen Sie die MIB-Attribute des Ports zurück, sodass sie auf ihre Standardwerte festgelegt werden, wenn bSetDefaultMIB wahr ist.
  • Setzen Sie die TX/Rx-Zustandscomputer für die PHY-Entität zurück, und legen Sie sie nur auf Rx-Zustand fest, um sicherzustellen, dass keine weiteren Frames übertragen werden.
  • Leeren Sie die Rx-Warteschlange des Adapters, und schließen Sie das Senden für jedes Paket in den TX-Warteschlangen ab.
  • Wenn der MAC-Adressparameter vorhanden ist, setzen Sie die MAC-Adresse des Ports auf den angegebenen Wert zurück.
  • Legen Sie den Portstatus auf INIT fest, bevor Sie den Vorgang zum Zurücksetzen von dot11 abschließen.

Wenn der zurückgesetzte Port als STA, AP oder Wi-Fi Direct Client oder GO ausgeführt wurde, hätte der Host die Verbindungsaufgabe ausgelöst, um die IHV-Komponente anzufordern, die Zuordnung zu den Peers vor dem Zurücksetzen zu senden. Daher muss die IHV-Komponente sie nicht erneut ausführen.

Aufgabenparameter

TLV Mehrere zulässige TLV-Instanzen Optional Beschreibung
WDI_TLV_DOT11_RESET_PARAMETERS Parameter für das Zurücksetzen von Dot11.
WDI_TLV_CONFIGURED_MAC_ADDRESS X Die MAC-Adresse, die für den Port verwendet werden soll.
WDI_TLV_CONFIGURED_MLO_LINK_MAC_ADDRESS X Ein Array von Multi-Link Operation (MLO) Link-MAC-Adressen.

Angabe des Vorgangsabschlusses

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11
Unterstützte Mindestversion (Server) Windows Server 2022
Header dot11wificxintf.h