OID_WDI_TASK_DOT11_RESET

Wichtig

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

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

Object Abbruchfähig Standardpriorität (Hosttreiberrichtlinie) Normale Ausführungszeit (Sekunden)
Port Nein 1 1

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

Die dot11-Zurücksetzung kombiniert die Semantik der 802.11 MLME- und PLME-Zurücksetzungsgrundsätze. Wenn die IHV-Komponente eine Dot11-Zurücksetzungsanforderung empfängt, sollten die folgenden Aufgaben ausgeführt werden.

  • Setzen Sie die MAC-Entität des Ports auf den ursprünglichen Zustand zurück.
  • Setzen Sie die MIB-Attribute des Ports zurück, sodass sie auf ihre Standardwerte festgelegt werden, wenn bSetDefaultMIB true ist.
  • Setzen Sie die TX/Rx-Zustandscomputer für die PHY-Entität zurück, und legen Sie sie nur auf den Rx-Zustand fest, um sicherzustellen, dass keine weiteren Frames übertragen werden.
  • Leeren Sie die Rx-Warteschlange des Adapters, und schließen Sie den Sendevorgang 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 punkt11 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 Aufgabe "Trennen" ausgelöst, um die IHV-Komponente aufzufordern, die Zuordnung an die Peers vor dem Zurücksetzen zu senden. Daher muss die IHV-Komponente dies nicht erneut tun.

Aufgabenparameter

TLV Mehrere TLV-Instanzen zulässig Optional BESCHREIBUNG
WDI_TLV_DOT11_RESET_PARAMETERS Parameter für das Zurücksetzen von punkt11.
WDI_TLV_CONFIGURED_MAC_ADDRESS X Die MAC-Adresse, die für den Port verwendet werden soll.

Vorgangsabschlussanzeige

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

Anforderungen

Unterstützte Mindestversion (Client)

Windows 10

Unterstützte Mindestversion (Server)

Windows Server 2016

Header

Dot11wdi.h