DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS Struktur (windot11.h)
Die DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS Struktur gibt die Ergebnisse des Zuordnungsvorgangs an, der von der Station 802.11 ausgeführt wird, nachdem eine Zuordnungsanforderung von einer Peerstation auf einer Infrastruktur BSS empfangen wurde.
Syntax
typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS PeerMacAddr;
ULONG uStatus;
UCHAR ucErrorSource;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;
Angehörige
Header
Der Typ, die Überarbeitung und die Größe der DOT11_INCOMING_ASSOC_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_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1 festgelegt werden.
Größe
Dieses Element muss auf Größe(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS) festgelegt werden.
Weitere Informationen zu diesen Mitgliedern finden Sie unter NDIS_OBJECT_HEADER.
PeerMacAddr
Die Mac-Adresse (Media Access Control) der Peerstation, die eine Zuordnungsanforderung gesendet hat.
uStatus
Der Status der Zuordnung mit der Peerstation. Wenn null, wird die Zuordnung erfolgreich ausgeführt. Wenn "nonzero" nicht vorhanden ist, schlägt die Zuordnung fehl.
ucErrorSource
Bei Nichtzero-Werten von uStatus-gibt dieses Element die Quelle des Fehlers an, der die Zuordnung verhindert. Die NIC muss ucErrorSource- auf einen der folgenden Werte festlegen:
DOT11_ASSOC_ERROR_SOURCE_OS
Der Miniporttreiber hat die Zuordnungsprozedur aufgrund von Systemfehlern abgelehnt, z. B. Fehler außerhalb des Arbeitsspeichers. In diesem Fall sollte uStatus- auf den vom Betriebssystem zurückgegebenen NDIS_STATUS_XXX oder NTSTATUS_XXX Code festgelegt werden.
DOT11_ASSOC_ERROR_SOURCE_REMOTE
Die AP oder die Peerstation hat das Zuordnungsverfahren abgelehnt. In diesem Fall sollte uStatus- auf den Statuscode 802.11 des Authentifizierungsrahmens 802.11, des Zuordnungsantwortframes oder des Antwortframes für die erneute Zuordnung festgelegt werden. Tabelle 19 im IEEE 802.11-2003 Specification enthält alle möglichen Werte. Der Miniporttreiber kann auch neue Werte in dieser IEEE-Spezifikation zurückgeben, wenn er geändert wird.
DOT11_ASSOC_ERROR_SOURCE_OTHER
Fehler bei der Zuordnung aus einem IHV-spezifischen Grund. In diesem Fall enthält uStatus- einen wert ungleich null, der vom IHV angegeben wird.
bReAssocReq
Ein boolescher Wert, der angibt, ob die Anforderung von der Peerstation eine erneute Zuordnungsanforderung ist.
bReAssocResp
Ein boolescher Wert, der angibt, ob die Antwort der NIC eine erneute Zuordnungsanforderung ist.
uAssocReqOffset
Der Offset des Anforderungsrahmens, der im Zuordnungsvorgang verwendet wird. Der Frame enthält Informationselemente (IEs), enthält jedoch nicht den MAC-Header 802.11.
uAssocReqSize
Die Länge des Anforderungsrahmens in Bytes, der im Zuordnungsvorgang verwendet wird. Der Frame enthält Informationselemente (IEs), enthält jedoch nicht den MAC-Header 802.11.
uAssocRespOffset
Der Offset des Antwortframes, der im Zuordnungsvorgang verwendet wird. Der Frame enthält Informationselemente (IEs), enthält jedoch nicht den MAC-Header 802.11.
uAssocRespSize
Die Länge des Antwortframes in Bytes, der im Zuordnungsvorgang verwendet wird. Der Frame enthält Informationselemente (IEs), enthält jedoch nicht den MAC-Header 802.11.
AuthAlgo
Der Authentifizierungsalgorithmus, den die Station 802.11 während des Zuordnungsvorgangs mit der Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das AuthAlgo--Mitglied finden Sie unter DOT11_AUTH_ALGORITHM.
UnicastCipher
Der Unicastchiffrealgorithmus, den die Station 802.11 während des Zuordnungsvorgangs mit der Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das UnicastCipher Member finden Sie unter DOT11_CIPHER_ALGORITHM.
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.
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. Jeder Eintrag ist ein ULONG-Wert.
Die Extensible Station (ExtSTA) msDot11ActivePhyList MIB-Objekt verweist auch auf die aktive PHY-Liste.
Einträge in der aktiven PHY-Liste können einen der folgenden Werte aufweisen:
- Eine PHY-ID, die von der Extensible Station (ExtSTA) angegeben wird, msDot11DesiredPhyList Management Information Base (MIB)-Objekt. Weitere Informationen zu diesem MIB-Objekt finden Sie unter OID_DOT11_DESIRED_PHY_LIST.
-
Eine PHY-ID von DOT11_PHY_ID_ANY. Der Miniporttreiber kann einen Eintrag auf diesen Wert festlegen, wenn das ExtSTA-msDot11ActivePhyList- MIB-Objekt alle PHY-IDs angibt, die durch die msDot11DesiredPhyList MIB-Objekt angegeben werden. Weitere Informationen zu diesem MIB-Objekt finden Sie unter OID_DOT11_ACTIVE_PHY_LIST.
Hinweis Ein Eintrag mit dem Wert DOT11_PHY_ID_ANY muss der einzige Eintrag in der aktiven PHY-Liste sein.
uActivePhyListSize
Die Länge in Bytes der aktiven PHY-Liste. Das uActivePhyListSize Mitglied muss ein Vielfaches von sizeof(ULONG)sein.
uBeaconOffset
Der Offset in Bytes des letzten übertragenen Beacon-Frames 802.11.
Der Beacon-Frame enthält den Beacon-Frameheader und alle Informationselemente (IEs), enthält jedoch nicht den MAC-Header 802.11. Das Beacon-Frame-Format ist in ISO/IEC 8802-11 definiert.
Der Beacon-Frame sollte der neueste Frame sein, der vom Treiber verwendet wird, außer dass Echtzeitparameter oder IEs, die mit der Datenrahmenflusssteuerung variieren, oder der Clientzuordnungsstatus wie Zeitstempel, Funkparameter, TIM, ERP und HT-IEs nicht genau sein muss,
uBeaconSize
Die Länge des letzten übertragenen 802.11 Beacon-Frames in Bytes.
Der Beacon-Frame enthält den Beacon-Frameheader und alle Informationselemente (IEs), enthält jedoch nicht den MAC-Header 802.11. Das Beacon-Frame-Format ist in ISO/IEC 8802-11 definiert.
Der Beacon-Frame sollte der neueste Frame sein, der vom Treiber verwendet wird, außer dass Echtzeitparameter oder IEs, die mit der Datenrahmenflusssteuerung variieren, oder der Clientzuordnungsstatus wie Zeitstempel, Funkparameter, TIM, ERP und HT-IEs nicht genau sein muss,
Bemerkungen
Der Native 802.11-Miniporttreiber enthält eine DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS Struktur, wenn der Treiber einen NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION Statusanzeige.
Die NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION Statusanzeige markiert das Ende eines Zuordnungsanzeigeblocks. Wenn die Zuordnung erfolgreich ist, muss die NIC die NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION Angabe machen, nachdem sie erfolgreich den entsprechenden Zuordnungsantwortrahmen an die Station gesendet hat, die ursprünglich die Zuordnung angefordert hat. Wenn die Zuordnung fehlschlägt, muss die NIC die NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION anzeigen, ob die Antwort erfolgreich gesendet wird oder nicht. Der Fehler kann darauf zurückzuführen sein, dass die NIC oder das Betriebssystem die Zuordnungsanforderung ablehnen oder aufgrund eines Fehlers, der nicht mit dem 802.11-Framework verknüpft ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen des Windows-Betriebssystems. |
| Header- | windot11.h (include Ndis.h) |