Freigeben über


OID_WDI_TASK_DOT11_RESET

Wichtig

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

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

Objekt Abortfähig Standardpriorität (Hosttreiberrichtlinie) Normale Ausführungszeit (Sekunden)
Hafen Nein 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 ein 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 der Zurücksetzung zu senden. Daher muss die IHV-Komponente sie nicht erneut ausführen.

Vorgangsparameter

TLV Mehrere zulässige TLV-Instanzen Wahlfrei 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.

Angabe des Vorgangsabschlusses

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

Anforderungen

Mindestens unterstützter Client

Windows 10

Mindestens unterstützter Server

Windows Server 2016

Kopfball

Dot11wdi.h