DOT11_PEER_INFO Struktur (windot11.h)
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_PEER_INFO Struktur gibt Informationen zu einer Peerstation innerhalb eines unabhängigen IbSS-Netzwerks (Basic Service Set) an.
Syntax
typedef struct _DOT11_PEER_INFO {
DOT11_MAC_ADDRESS MacAddress;
USHORT usCapabilityInformation;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipherAlgo;
DOT11_CIPHER_ALGORITHM MulticastCipherAlgo;
BOOLEAN bWpsEnabled;
USHORT usListenInterval;
UCHAR ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2];
USHORT usAssociationID;
DOT11_ASSOCIATION_STATE AssociationState;
DOT11_POWER_MODE PowerMode;
LARGE_INTEGER liAssociationUpTime;
DOT11_PEER_STATISTICS Statistics;
} DOT11_PEER_INFO, *PDOT11_PEER_INFO;
Angehörige
MacAddress
Die Mac-Adresse (Media Access Control) der Peerstation in einem unabhängigen BSS(IBSS)-Netzwerk.
usCapabilityInformation
Das Feld "802.11 Capability Information" aus den Beacon- oder Probeantwortframes, die die Station 802.11 zuletzt vom Peer erhalten hat.
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.
Dieses Element ist nicht definiert, wenn der Peer nicht zugeordnet ist.
UnicastCipherAlgo
Der Unicastchiffrealgorithmus, den die Station 802.11 während des Zuordnungsvorgangs mit der Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das UnicastCipherAlgo Member finden Sie unter DOT11_CIPHER_ALGORITHM.
Dieses Element ist nicht definiert, wenn der Peer nicht zugeordnet ist.
MulticastCipherAlgo
Der Multicastchiffrealgorithmus, den die Station 802.11 während des Zuordnungsvorgangs mit der Peerstation aufgelöst hat. Weitere Informationen zum Datentyp für das MulticastCipherAlgo--Element finden Sie unter DOT11_CIPHER_ALGORITHM.
Dieses Element ist nicht definiert, wenn der Peer nicht zugeordnet ist.
bWpsEnabled
Ein boolescher Wert, der angibt, ob wiFi Protected Setup (WPS) für die Peerstation aktiviert ist. Wenn TRUEist, ist WPS aktiviert, und die vom Peer verwendeten Authentifizierungs- und Verschlüsselungsalgorithmen unterscheiden sich möglicherweise von den Algorithmen, die für die AP aktiviert sind.
Dieses Element sollte nicht verwendet werden, wenn der Peer nicht zugeordnet ist.
usListenInterval
Ein USHORT-Wert, der das Listenintervallfeld 802.11 definiert, das von der Zuordnungsanforderung abgerufen wurde.
Dieses Element hat einen Wert von Null, wenn der Peer nicht zugeordnet ist.
ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2]
Ein UCHAR-Wert, der die von der Peerstation unterstützten Datenraten angibt. Diese Raten basieren auf den 802,11 Unterstützten IE-Raten von den Beacon- oder Probeantwortframes, die die 802.11-Station zuletzt vom Peer erhalten hat.
Jeder Eintrag in der ucPeerSupportedRates Array ist der Wert eines Indexes innerhalb der Tabelle der datenraten, die über eine Abfrage von OID_DOT11_DATA_RATE_MAPPING_TABLE. Der Indexwert muss zwischen 2 und 127 sein.
Dieses Element hat einen Wert von Null, wenn der Peer nicht zugeordnet ist.
usAssociationID
Ein USHORT-Wert, der das 802.11-Zuordnungs-ID-Feld aus den Zuordnungs- oder Erneutzuordnungsantwortframes angibt, die die 802.11-Station von der AP empfangen hat.
Dieses Element weist einen Wert von 0xFFFF auf, wenn der Peer nicht zugeordnet ist.
AssociationState
Ein DOT11_ASSOCIATION_STATE-type-Wert, der den Authentifizierungs- und Zuordnungsstatus 802.11 der Peerstation angibt. Der Zustand kann entweder dot11_assoc_state_auth_unassoc oder dot11_assoc_state_auth_assocsein.
Im IEEE 802.11 Standardist das 802.11-Authentifizierungsverfahren für ein unabhängiges Netzwerk optional. Abhängig von der IHV-Implementierung kann der durch den dot11_assoc_state_auth_unassoc Enumerationswert dargestellte Zustand daher möglicherweise nicht anwendbar sein.
PowerMode
Ein wert vom Typ "DOT11_POWER_MODE", der den neuesten Energieverwaltungsmodus der Peerstation beschreibt.
liAssociationUpTime
Ein LARGEINTEGER-Wert, der den Zeitstempel angibt, wenn die 802.11-Zuordnungsprozedur erfolgreich abgeschlossen wurde. Der Miniporttreiber ruft NdisGetCurrentSystemTime auf, um den Zeitstempel des Zuordnungsabschlusses abzurufen.
Dieses Element hat einen Wert von Null, wenn der Peer nicht zugeordnet ist.
Statistics
Die Statistischen Indikatoren für den Datenverkehr, definiert durch die DOT11_PEER_STATISTICS-Struktur.
Dieses Element hat einen Wert von Null, wenn der Peer nicht zugeordnet ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows-Betriebssystemen. |
| Header- | windot11.h (include Ndis.h) |