DOT11_ROAMING_START_PARAMETERS-Struktur (windot11.h)

Artikel
02/27/2024

Wichtig Die native WLAN-Schnittstelle 802.11 ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows driver model.

Die DOT11_ROAMING_START_PARAMETERS-Struktur gibt den Grund an, warum der Native 802.11-Miniporttreiber einen Roamingvorgang ausführt. Der Treiber enthält eine DOT11_ROAMING_START_PARAMETERS-Struktur, wenn der Treiber eine NDIS_STATUS_DOT11_ROAMING_START status Angabe.

Syntax

typedef struct DOT11_ROAMING_START_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  DOT11_MAC_ADDRESS  AdhocBSSID;
  DOT11_SSID         AdhocSSID;
  DOT11_ASSOC_STATUS uRoamingReason;
} DOT11_ROAMING_START_PARAMETERS, *PDOT11_ROAMING_START_PARAMETERS;

Member

Header

Typ, Revision und Größe der DOT11_ROAMING_START_PARAMETERS-Struktur. Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss die Member von Header auf die folgenden Werte festlegen:

Typ

Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.

Revision

Dieser Member muss auf DOT11_ROAMING_START_PARAMETERS_REVISION_1 festgelegt werden.

Size

Dieser Member muss auf sizeof(DOT11_ROAMING_START_PARAMETERS) festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

AdhocBSSID

Wenn das MIB-Objekt IEEE 802.11 dot11DesiredBSSType auf dot11_BSS_type_independent festgelegt ist, enthält das AdhocBSSID-Element den BSS-Bezeichner (Basic Service Set, BSSID) des unabhängigen BSS-Netzwerks (IBSS), zu dem die Station 802.11 wechseln möchte.

Hinweis IBSS (Ad hoc) und SoftAP sind veraltet. Verwenden Sie ab Windows 8.1 und Windows Server 2012 R2 Wi-Fi Direct.

Wenn das MIB-Objekt dot11DesiredBSSType auf dot11_BSS_type_infrastructure festgelegt ist, muss der Miniporttreiber AdhocBSSID mit Nullen füllen.

Weitere Informationen zum Datentyp für diesen Member finden Sie unter DOT11_MAC_ADDRESS.

AdhocSSID

Wenn das MIB-Objekt dot11DesiredBSSType auf dot11_BSS_type_independent festgelegt ist, enthält das AdhocSSID-Element den Service Set Identifier (SSID) des IBSS-Netzwerks, zu dem die Station 802.11 einen Roam versucht.

Hinweis IBSS (Ad hoc) und SoftAP sind veraltet. Verwenden Sie ab Windows 8.1 und Windows Server 2012 R2 Wi-Fi Direct.

Wenn das MIB-Objekt dot11DesiredBSSSType auf dot11_BSS_type_infrastructure festgelegt ist, muss der Miniporttreiber AdhocSSID mit Nullen füllen.

Weitere Informationen zum Datentyp für diesen Member finden Sie unter DOT11_SSID.

Weitere Informationen zum MIB-Objekt IEEE 802.11 dot11DesiredBSSSType finden Sie unter OID_DOT11_DESIRED_BSS_TYPE.

uRoamingReason

Der Grund für die Roaming-Station 802.11, die als DOT11_ASSOC_STATUS-Wert formatiert ist.

Hinweise

Weitere Informationen zum Roamingvorgang finden Sie unter Roamingvorgänge.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	windot11.h (include Ndis.h)