DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS-Struktur (windot11.h)
Die DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS-Struktur gibt die Ergebnisse des Zuordnungsvorgangs an, der von der 802.11-Station ausgeführt wird, nachdem sie eine Zuordnungsanforderung von einer Peerstation auf einer Infrastruktur-BSS empfangen hat.
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;
Member
Header
Der Typ, die Revision 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 von Header auf die folgenden Werte festlegen:
Typ
Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.
Revision
Dieser Member muss auf DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1 festgelegt werden.
Size
Dieser Member muss auf sizeof(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS) festgelegt werden.
Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.
PeerMacAddr
Die MAC-Adresse (Media Access Control) der Peerstation, die eine Zuordnungsanforderung gesendet hat.
uStatus
Die status der Zuordnung zur Peerstation. Wenn null, ist die Zuordnung erfolgreich. Bei nichtzero schlägt die Zuordnung fehl.
ucErrorSource
Für nichtzero-Werte von uStatus gibt dieses Member 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. aufgrund von Fehlern aus dem Arbeitsspeicher. In diesem Fall sollte uStatus auf den NDIS_STATUS_XXX oder NTSTATUS_XXX code festgelegt werden, der vom Betriebssystem zurückgegeben wird.
DOT11_ASSOC_ERROR_SOURCE_REMOTE
Der AP oder die Peerstation hat das Zuordnungsverfahren abgelehnt. In diesem Fall sollte uStatus auf den 802.11-status Code des 802.11-Authentifizierungsrahmens, des Zuordnungsantwortrahmens oder des Antwortrahmens für die erneute Zuordnung festgelegt werden. Tabelle 19 in der IEEE 802.11-2003-Spezifikation enthält alle möglichen Werte. Der Miniporttreiber kann auch neue Werte in dieser IEEE-Spezifikation zurückgeben, wenn sie geändert wird.
DOT11_ASSOC_ERROR_SOURCE_OTHER
Die Zuordnung ist aus einem IHV-spezifischen Grund fehlgeschlagen. In diesem Fall enthält uStatus einen nichtzero-Wert, der vom IHV angegeben wird.
bReAssocReq
Ein boolescher Wert, der angibt, ob es sich bei der Anforderung von der Peerstation um eine Anforderung zur erneuten Zuordnung handelt.
bReAssocResp
Ein boolescher Wert, der angibt, ob es sich bei der Antwort der NIC um eine Anforderung zur erneuten Zuordnung handelt.
uAssocReqOffset
Der Offset des Anforderungsrahmens, der im Zuordnungsvorgang verwendet wird. Der Frame enthält Informationselemente(IEs), aber 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), aber nicht den MAC-Header 802.11.
uAssocRespOffset
Der Offset des Antwortframes, der im Zuordnungsvorgang verwendet wird. Der Frame enthält Informationselemente(IEs), aber 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), aber 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-Element finden Sie unter DOT11_AUTH_ALGORITHM.
UnicastCipher
Der Unicast-Verschlüsselungsalgorithmus, den die Station 802.11 während des Zuordnungsvorgangs mit der Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das UnicastCipher-Element finden Sie unter DOT11_CIPHER_ALGORITHM.
MulticastCipher
Der Multicast-Verschlüsselungsalgorithmus, den die 802.11-Station während des Zuordnungsvorgangs mit dem AP oder der 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-Bezeichner (IDs), die die 802.11-Station zum Senden oder Empfangen von Paketen über die BSS-Netzwerkverbindung verwendet. Jeder Eintrag ist ein ULONG-Wert.
Der Extensible Station (ExtSTA) msDot11ActivePhyList MIB-Objec verweist auch auf die aktive PHY-Liste.
Einträge in der aktiven PHY-Liste können einer der folgenden Werte sein:
- Eine PHY-ID, die vom ExtSTA-Objekt (Extensible Station) msDot11DesiredPhyList (Management Information Base) angegeben wird. Weitere Informationen zu diesem MIB-Objekt finden Sie unter OID_DOT11_DESIRED_PHY_LIST.
-
Eine PHY-ID mit DOT11_PHY_ID_ANY. Der Miniporttreiber kann einen Eintrag auf diesen Wert festlegen, wenn das MiB-Objekt extSTA msDot11ActivePhyList alle PHY-IDs angibt, die vom MIB-Objekt msDot11DesiredPhyList 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 der aktiven PHY-Liste in Bytes. Das uActivePhyListSize-Element muss ein Vielfaches von sizeof(ULONG)sein.
uBeaconOffset
Der Offset in Bytes des zuletzt übertragenen 802.11 Beacon-Frames.
Der Beacon-Frame enthält den Beacon-Frameheader und alle Informationselemente (IEs), aber nicht den MAC-Header 802.11. Das Beaconframeformat ist in ISO/IEC 8802-11 definiert.
Der Beacon-Frame sollte der neueste frame sein, der vom Treiber verwendet wird, mit der Ausnahme, dass Echtzeitparameter oder IEs, die mit der Steuerung des Datenrahmenflusses oder der Clientzuordnung status wie Zeitstempel, Funkparameter, TIM, ERP und HT-IEs variieren, nicht genau sein müssen.
uBeaconSize
Die Länge des zuletzt übertragenen 802.11 Beacon-Frames in Bytes.
Der Beacon-Frame enthält den Beacon-Frameheader und alle Informationselemente (IEs), aber nicht den MAC-Header 802.11. Das Beaconframeformat ist in ISO/IEC 8802-11 definiert.
Der Beacon-Frame sollte der neueste frame sein, der vom Treiber verwendet wird, mit der Ausnahme, dass Echtzeitparameter oder IEs, die mit der Steuerung des Datenrahmenflusses oder der Clientzuordnung status wie Zeitstempel, Funkparameter, TIM, ERP und HT-IEs variieren, nicht genau sein müssen.
Hinweise
Der Native 802.11-Miniporttreiber enthält eine DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS-Struktur, wenn der Treiber eine NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION status Indikation.
Die NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION status-Angabe markiert das Ende eines Zuordnungsanzeigeblocks. Wenn die Zuordnung erfolgreich ist, muss die NIC den NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION Hinweis geben, nachdem sie erfolgreich den entsprechenden Zuordnungsantwortrahmen an die Station gesendet hat, die die Zuordnung ursprünglich angefordert hat. Wenn die Zuordnung fehlschlägt, muss die NIC den NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION Hinweis geben, ob die Antwort erfolgreich gesendet wurde oder nicht. Der Fehler kann darauf zurückzuführen sein, dass die NIC oder das Betriebssystem die Zuordnungsanforderung ablehnt oder auf einen Fehler zurückzuführen ist, der nicht mit dem 802.11-Framework zusammenhängt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und höheren Versionen des Windows-Betriebssystems. |
| Kopfzeile | windot11.h (include Ndis.h) |