DOT11_PEER_INFO-Struktur (windot11.h)

Wichtig Die Native 802.11 Wireless LAN-Schnittstelle 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-Treibermodell.

 

Die DOT11_PEER_INFO-Struktur gibt Informationen zu einer Peerstation in einem unabhängigen IBSS-Netzwerk (Basic Service Set) an.

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

 

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;

Member

MacAddress

Die MAC-Adresse (Media Access Control) der Peerstation in einem unabhängigen BSS-Netzwerk (IBSS).

usCapabilityInformation

Das Feld "802.11 Capability Information" aus dem Beacon- oder Testantwortrahmen, das die 802.11-Station zuletzt vom Peer empfangen 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-Element finden Sie unter DOT11_AUTH_ALGORITHM.

Dieser Member ist nicht definiert, wenn der Peer nicht zugeordnet ist.

UnicastCipherAlgo

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 UnicastCipherAlgo-Element finden Sie unter DOT11_CIPHER_ALGORITHM.

Dieser Member ist nicht definiert, wenn der Peer nicht zugeordnet ist.

MulticastCipherAlgo

Der Multicast-Verschlüsselungsalgorithmus, 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.

Dieser Member ist nicht definiert, wenn der Peer nicht zugeordnet ist.

bWpsEnabled

Ein boolescher Wert, der angibt, ob WPS (WiFi Protected Setup) für die Peerstation aktiviert ist. Wenn TRUE aktiviert ist, ist WPS aktiviert, und die vom Peer verwendeten Authentifizierungs- und Verschlüsselungsalgorithmen unterscheiden sich möglicherweise von den Algorithmen, die auf dem 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 aus der Zuordnungsanforderung abgerufen wurde.

Dieser Member hat den Wert 0, 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 Supported Rates IE von den Beacon- oder Testantwortframes, die die 802.11-Station zuletzt vom Peer empfangen hat.

Jeder Eintrag im Array ucPeerSupportedRates ist der Wert eines Indexes in der Tabelle der Datenraten, der über eine Abfrage von zurückgegeben wird. OID_DOT11_DATA_RATE_MAPPING_TABLE. Der Indexwert muss zwischen 2 und 127 sein.

Dieser Member hat den Wert 0, wenn der Peer nicht zugeordnet ist.

usAssociationID

Ein USHORT-Wert, der das 802.11-Zuordnungs-ID-Feld aus den Zuordnungs- oder Neuzuordnungsantwortframes angibt, die die 802.11-Station vom AP empfangen hat.

Dieser Member hat den Wert 0xFFFF, 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_assoc sein.

Im IEEE 802.11 Standard ist das 802.11-Authentifizierungsverfahren für ein unabhängiges Netzwerk optional. Daher ist je nach IHV-Implementierung der Zustand, der durch den dot11_assoc_state_auth_unassoc Enumerationswert dargestellt wird, möglicherweise nicht anwendbar.

PowerMode

Ein wert vom Typ DOT11_POWER_MODE, der den aktuellen Energieverwaltungsmodus der Peerstation beschreibt.

liAssociationUpTime

Ein LARGEINTEGER-Wert, der den Zeitstempel angibt, wenn die Zuordnungsprozedur 802.11 erfolgreich abgeschlossen wurde. Der Miniporttreiber ruft NdisGetCurrentSystemTime auf, um den Zeitstempel der Zuordnungsvervollständigung abzurufen.

Dieser Member hat den Wert 0, wenn der Peer nicht zugeordnet ist.

Statistics

Die Statistikindikatoren für den Datenverkehr, die von der DOT11_PEER_STATISTICS-Struktur definiert werden.

Dieser Member hat den Wert 0, wenn der Peer nicht zugeordnet ist.

Anforderungen

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

Weitere Informationen

DOT11_POWER_MODE

DOT11_ASSOCIATION_STATE

NdisGetCurrentSystemTime

DOT11_PEER_STATISTICS

DOT11_PEER_INFO_LIST

NDIS_OBJECT_HEADER