DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur (windot11.h)

Artikel
02/07/2025

Wichtig

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

Die DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur gibt die Ergebnisse des Zuordnungsvorgangs an, der von der Station 802.11 mit einem Zugriffspunkt (AP) oder einer Peerstation ausgeführt wird. Der Native 802.11-Miniporttreiber enthält eine DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur, wenn der Miniporttreiber eine NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION Statusanzeige macht.

Syntax

typedef struct DOT11_ASSOCIATION_COMPLETION_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  DOT11_MAC_ADDRESS      MacAddr;
  DOT11_ASSOC_STATUS     uStatus;
  BOOLEAN                bReAssocReq;
  BOOLEAN                bReAssocResp;
  ULONG                  uAssocReqOffset;
  ULONG                  uAssocReqSize;
  ULONG                  uAssocRespOffset;
  ULONG                  uAssocRespSize;
  ULONG                  uBeaconOffset;
  ULONG                  uBeaconSize;
  ULONG                  uIHVDataOffset;
  ULONG                  uIHVDataSize;
  DOT11_AUTH_ALGORITHM   AuthAlgo;
  DOT11_CIPHER_ALGORITHM UnicastCipher;
  DOT11_CIPHER_ALGORITHM MulticastCipher;
  ULONG                  uActivePhyListOffset;
  ULONG                  uActivePhyListSize;
  BOOLEAN                bFourAddressSupported;
  BOOLEAN                bPortAuthorized;
  UCHAR                  ucActiveQoSProtocol;
  DOT11_DS_INFO          DSInfo;
  ULONG                  uEncapTableOffset;
  ULONG                  uEncapTableSize;
  DOT11_CIPHER_ALGORITHM MulticastMgmtCipher;
  ULONG                  uAssocComebackTime;
} DOT11_ASSOCIATION_COMPLETION_PARAMETERS, *PDOT11_ASSOCIATION_COMPLETION_PARAMETERS;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

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

Art

Dieses Element muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.

Revision

Dieses Element muss auf DOT11_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1 festgelegt werden.

Größe

Dieses Element muss auf sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS)festgelegt werden.

Weitere Informationen zu diesen Mitgliedern finden Sie unter NDIS_OBJECT_HEADER.

MacAddr

Die Mac-Adresse (Media Access Control) des Zugriffspunkts (AP) (für BSS-Netzwerke der Infrastruktur) oder Peerstation (für unabhängige BSS-Netzwerke), mit denen die Station 802.11 versucht hat, eine Verbindung herzustellen.

uStatus

Der Abschlussstatus des Zuordnungsvorgangs, wie durch einen für DOT11_ASSOC_STATUSdefinierten Wert angegeben.

bReAssocReq

Ein boolescher Wert, der angibt, ob die 802.11-Station einen 802.11 Association- oder Reassociation-Frame an die AP gesendet hat. Wenn TRUE, hat die Station 802.11 einen 801.11 Reassociation Request Frame an die AP gesendet. Wenn FALSE, hat die Station 802.11 einen Zuordnungsanforderungsrahmen 802.11 an die AP gesendet.

Ein Wert von TRUE für das bReAssocReq Member ist nur gültig, wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_infrastructurefestgelegt ist.

bReAssocResp

Ein boolescher Wert, der angibt, ob die 802.11-Station einen 802.11 Association- oder Reassociation-Frame von der AP empfangen hat. Wenn TRUE, erhielt die Station 802.11 einen 802.11 Reassociation Response Frame von der AP. Wenn FALSE-, erhielt die Station 802.11 einen Zuordnungsantwortframe 802.11 von der AP.

Ein Wert von TRUE für das bReAssocResp Member ist nur gültig, wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_infrastructurefestgelegt ist.

uAssocReqOffset

Der Offset des Anforderungsrahmens, der im Zuordnungsvorgang verwendet wird. Der Frame enthält nicht den MAC-Header 802.11.

Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur enthält.

Der Zuordnungsanforderungsrahmen, der vom Miniporttreiber zurückgegeben wird, hängt von der Einstellung des IEEE 802.11 dot11DesiredBSSType MIB-Objekt ab:

Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_infrastructure festgelegt ist, der Frame ist entweder der Frame 802.11 Association Request (if bReAssocReq is FALSE) or Reassociation Request frame (if bReAssocReq is TRUE), die an die AP gesendet wurde. Der Miniporttreiber muss einen 802.11 Probeanforderungsrahmen zurückgeben, der entweder vom Initiator der Zuordnung gesendet oder vom Treiber basierend auf Informationen erstellt wird, die während des Zuordnungsvorgangs ausgetauscht wurden.
Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_independent festgelegt ist, muss der Miniporttreiber den uAssocReqOffset Element auf Null festlegen.

Der Miniporttreiber muss die uAssocReqOffset und uAssocReqSize Member auf Null festlegen, wenn ein Anforderungsrahmen während des Zuordnungsvorgangs nicht gesendet werden konnte. Wenn die AP beispielsweise den Authentifizierungsrahmen 802.11 fehlgeschlagen hat, der von der Station 802.11 gesendet wurde, muss der Miniporttreiber uAssocReqOffset- und uAssocReqSize auf Null festlegen.

uAssocReqSize

Die Länge des Anforderungsrahmens, der im Zuordnungsvorgang verwendet wird. Die Länge des Frames enthält nicht den MAC-Header 802.11.

Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_independentfestgelegt ist, muss der Miniporttreiber den uAssocReqSize Member auf Null festlegen.

uAssocRespOffset

Der Offset des Antwortframes, der im Zuordnungsvorgang verwendet wird. Der Frame enthält nicht den MAC-Header 802.11.

Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur enthält.

Der Zuordnungsantwortframe, der vom Miniporttreiber zurückgegeben wird, hängt von der Einstellung des IEEE 802.11 dot11DesiredBSSType MIB-Objekt ab:

Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_infrastructure festgelegt ist, der Frame ist entweder der Frame "802.11 Association Response" (wenn bReAssocReqTRUEist) oder "Reassociation Response"-Frame (wenn bReAssocReqFALSEist), der von der AP empfangen wurde. Der Miniporttreiber muss einen 802.11 Probe Response Frame zurückgeben, der entweder an den Initiator der Zuordnung gesendet oder vom Treiber basierend auf Informationen erstellt wird, die während des Zuordnungsvorgangs ausgetauscht wurden.
Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_independent festgelegt ist, muss der Miniporttreiber den uAssocRespOffset Element auf Null festlegen.
Der Miniporttreiber muss die uAssocRespOffset- und uAssocRespSize Member auf Null festlegen, wenn er während des Zuordnungsvorgangs keinen Antwortframe empfangen hat.

uAssocRespSize

Die Länge des Antwortframes, der im Zuordnungsvorgang verwendet wird. Die Länge des Frames enthält nicht den MAC-Header 802.11.

Wenn das dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_independentfestgelegt ist, muss der Miniporttreiber den uAssocRespSize Element auf Null festlegen.

uBeaconOffset

Der Offset des letzten empfangenen 802.11 Beacon- oder Probe Response-Frames. Der Miniporttreiber muss den MAC-Header 802.11 für diese Frames ausschließen, wenn die NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION Statusanzeige erstellt wird.

Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur enthält.

Anmerkung

Wenn der für die Zuordnung verwendete Authentifizierungsalgorithmus Wi-Fi Protected Access (WPA) oder IEEE 802.11i Robust Security Network Association (RSNA) war, muss der Miniporttreiber immer den letzten empfangenen 802.11 Beacon-Frame zurückgeben und darf den uBeaconOffset und uBeaconSize Member nicht auf Null festlegen.

uBeaconSize

Die Länge des letzten empfangenen 802.11 Beacon-Frames. Die Länge des Frames enthält nicht den MAC-Header 802.11.

uIHVDataOffset

Der Offset eines Datenblocks in einem proprietären Format, das vom IHV definiert wird. Der IHV kann diesen Datenblock für alle Zwecke verwenden, die sich auf die NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION Statusanzeige beziehen.

Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur enthält.

Wenn der Miniporttreiber keine IHV-Daten in der NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION Statusanzeige zurückgibt, muss er uIHVDataOffset- auf Null festlegen.

uIHVDataSize

Die Länge des Datenblocks, der vom IHV für die NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION Statusanzeige verwendet wird. Wenn der Miniporttreiber in diesem Hinweis keine IHV-Daten zurückgibt, muss er uIHVDataSize auf Null festlegen.

AuthAlgo

Der Authentifizierungsalgorithmus, den die 802.11-Station während des Zuordnungsvorgangs mit der AP- oder Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das AuthAlgo--Mitglied finden Sie unter DOT11_AUTH_ALGORITHM.

Der Miniporttreiber muss dieses Element auf Null festlegen, wenn uStatus- nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt ist.

UnicastCipher

Der Unicast-Verschlüsselungsalgorithmus, den die Station 802.11 während des Zuordnungsvorgangs mit der AP- oder Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das UnicastCipher Member finden Sie unter DOT11_CIPHER_ALGORITHM.

Der Miniporttreiber muss dieses Element auf Null festlegen, wenn uStatus- nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt ist.

MulticastCipher

Der Multicastchiffrealgorithmus, den die Station 802.11 während des Zuordnungsvorgangs mit der AP- oder Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das MulticastCipher--Element finden Sie unter DOT11_CIPHER_ALGORITHM

Der Miniporttreiber muss dieses Element auf Null festlegen, wenn uStatus- nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt ist.

uActivePhyListOffset

Der Offset der Liste der PHY-IDs (IDs), die die 802.11-Station zum Senden oder Empfangen von Paketen in der BSS-Netzwerkverbindung verwendet.

Das Extensible Station (ExtSTA) msDot11ActivePhyList MIB-Objekt verweist auch auf die aktive PHY-Liste.

Weitere Informationen zu diesem MIB-Objekt finden Sie unter OID_DOT11_ACTIVE_PHY_LIST.

Einträge in der aktiven PHY-Liste können einen der folgenden Werte aufweisen:

Eine PHY-ID, die vom ExtSTA-msDot11DesiredPhyList MIB-Objekt angegeben wird. Weitere Informationen zu diesem MIB-Objekt finden Sie unter OID_DOT11_DESIRED_PHY_LIST.
DOT11_PHY_ID_ANY. Der Miniporttreiber kann einen Eintrag auf diesen Wert festlegen, wenn das msDot11ActivePhyList MIB-Objekt alle PHY-IDs angibt, die durch das msDot11DesiredPhyList MIB-Objekt angegeben werden. Ein Eintrag mit dem Wert DOT11_PHY_ID_ANY darf der einzige Eintrag in der aktiven PHY-Liste sein.

Der Offset der aktiven PHY-Liste ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur enthält.

Der Miniporttreiber muss die uActivePhyListOffset- und uActivePhyListSize-Elemente auf Null festlegen, wenn uStatus- nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt ist.

uActivePhyListSize

Die Länge der aktiven PHY-Liste. Das uActivePhyListSize Mitglied muss ein Vielfaches von sizeof(ULONG)sein.

bFourAddressSupported

Ein boolescher Wert, der, wenn er auf TRUEfestgelegt ist, angibt, dass die Station 802.11 einer AP zugeordnet ist, die Verteilungssystemdienste (DS) für ISO Layer 2-Überbrückung auf allen Stationen im BSS-Netzwerk unterstützt, einschließlich Mobile Stationen und APs. Die Bestimmung dieser Unterstützung bezieht sich auf die Umsetzung des IHV.

Ein Miniporttreiber muss den bFourAddressSupported Member auf FALSE- festlegen, wenn einer der folgenden Werte zutrifft:

Das IEEE 802.11 dot11DesiredBSSType MIB-Objekt ist auf dot11_BSS_type_independentfestgelegt.
Die Station 802.11 hat keinem AP zugeordnet, der DS-Dienste unterstützt oder nicht ermitteln kann, ob die AP DS-Dienste unterstützt.
Der uStatus- Member ist nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt.

bPortAuthorized

Ein boolescher Wert, der bei Festlegung auf TRUEangibt, dass die 802.11-Station während des Zuordnungsvorgangs die Portautorisierung erfolgreich ausgeführt hat. Die Portautorisierung kann entweder auf den IEEE 802.1X/802.11i-Standards oder einem proprietären Algorithmus basieren, der vom IHV entwickelt wird.

Der Miniporttreiber muss bPortAuthorized- auf FALSE- festlegen, wenn einer der folgenden Werte zutrifft:

Die Station 802.11 führt keine Portautorisierung durch.
Der uStatus- Member ist nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt.

Weitere Informationen zur Portautorisierung finden Sie unter Port-Based Netzwerkzugriff.

ucActiveQoSProtocol

Ein Flag, das das QoS-Protokoll (Quality of Service) angibt, das derzeit für diese Zuordnung aktiv ist. Dieses Element ist entweder Null (gibt an, dass kein QoS-Protokoll aktiv ist) oder eines der folgenden Flags:

DOT11_QOS_PROTOCOL_FLAG_WMM

Die NIC verwendet das WMM QoS-Protokoll 802.11.

DOT11_QOS_PROTOCOL_FLAG_11E

Die NIC verwendet das 802.11e QoS-Protokoll.

DSInfo

Ein DOT11_DS_INFO Wert, der angibt, ob die Station 802.11 vom vorherigen Zuordnungsvorgang mit demselben DS verbunden ist.

Das DSInfo Members ist als DOT11_DS_INFO Enumeration formatiert, die die folgenden Werte angibt:

DOT11_DS_CHANGED

Die Station 802.11 ist nach dem Verbandsbetrieb mit einem neuen DS verbunden.

DOT11_DS_UNCHANGED

Die Station 802.11 ist vom Verbandsbetrieb mit demselben DS verbunden.

DOT11_DS_UNKNOWN

Der Miniporttreiber kann nicht ermitteln, ob sich der DS nach dem Zuordnungsvorgang geändert hat.

Anmerkung

Der Miniporttreiber muss DSInfo- auf DOT11_DS_UNKNOWN festlegen, wenn das Dot11DesiredBSSType MIB-Objekt auf dot11_BSS_type_independentfestgelegt ist.

uEncapTableOffset

Der Offset der Liste der IEEE EtherType-Kapselungen für die BSS-Zuordnung.

Dieser Offset ist relativ zum Anfang des Puffers, der die DOT11_ASSOCIATION_COMPLETION_PARAMETERS Struktur enthält. Der Wert uEncapTableOffset- muss an einer Grenze von 4 Byte ausgerichtet werden.

Der Miniporttreiber formatiert jeden Eintrag in dieser Liste als DOT11_ENCAP_ENTRY Struktur.

Weitere Informationen zur EtherType-Kapselungsliste finden Sie unter 802.11 Payload Kapselung.

uEncapTableSize

Die Länge der EtherType-Kapselungsliste.

MulticastMgmtCipher

Der Multicastchiffrealgorithmus, den die NIC für die Zuordnung für den Managementframeschutz (MFP) auswähtet (aushandelt). Wenn MFP ausgehandelt wird, sollte dieses Mitglied DOT11_CIPHER_ALGO_BIP werden. Wenn MFP nicht ausgehandelt wird, sollte dieses Feld DOT11_CIPHER_ALGO_NONE werden.

uAssocComebackTime

Wenn eine (re)zuordnung mit dem 802.11-Grundcode 30 fehlschlägt ("Zuordnungsanforderung vorübergehend abgelehnt, versuchen Sie es später erneut.") dieses Mitglied gibt den Wert der Zuordnungsrücklaufzeit an, die vom Zugriffspunkt (AP) angefordert wurde. Der 802.11-Nichtzuordnungsgrundcode ist in den niedrigsten 16 Bits von uStatus- vorhanden, wenn er auf eine Zuordnungsanforderung antwortet.

Der automatische Verbindungsdienst von Windows fügt die AP zu einer blockierten Liste hinzu und versucht nicht, mindestens die angegebene Comebackzeit erneut zu verbinden. Die NIC verhält sich wie eine normale fehlgeschlagene Authentifizierung, bis die nächste Verbindungssequenz gestartet wird. Nachdem das angegebene Timeout(Comeback) verstrichen ist und der Verbindungsprozess beendet wird, findet Windows entweder eine bessere alternative Verbindung oder ein Comeback zu dieser Verbindung. Dieser in diesem Element festgelegte Wert sollte die in der Spezifikation 802.11 definierten Zeiteinheiten verwenden. Beispiel: TU.

Bemerkungen

Der Miniporttreiber muss die uEncapTableOffset- und uEncapTableSize Member auf Null festlegen, wenn einer der folgenden Werte zutrifft:

Die BSS-Zuordnung erfordert keine Änderungen an der Standardliste der EtherType-Kapselungen des Betriebssystems.
Der uStatus- Member ist nicht auf DOT11_ASSOCIATION_STATUS_SUCCESS festgelegt.
Die Extensible Station (ExtSTA) dot11DesiredBSSType Management Information Base (MIB)-Objekt ist auf dot11_BSS_type_independentfestgelegt.

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

Weitere Informationen zum Zuordnungsvorgang finden Sie unter Zuordnungsvorgänge.

Management Frame Protection wird ausgehandelt, wenn ein Zugriffspunkt (AP) und STA das Management Frame Protection Capable (MFPC)-Feld in ihren jeweiligen RSN-IEs während des (re)association procedure (d.h. re)association procedure (d. h. auf 1) festlegen. Beacon- oder Probeantwort für AP und (re)association request for STA) und beide Parteien bestätigen, dass das Management Frame Protection-fähige Bit im 4-Wege-Handshake (Nachrichten M2 und M3 des 802.11i 4-Wege-Handshake) auf 1 festgelegt ist.