DOT11_BSS_ENTRY Struktur (windot11.h)

Wichtig Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN-Gerätetreiberschnittstelle (WDI). Weitere Informationen zu WDI finden Sie im Wlan-Treibermodell für universelle Windows-Geräte.
 
Die DOT11_BSS_ENTRY Struktur definiert einen IEEE 802.11 Beacon oder Response Frame, den die 802.11-Station während des letzten Scanvorgangs erhalten hat.

Syntax

typedef struct DOT11_BSS_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  BOOLEAN                           bInRegDomain;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBufferLength;
  UCHAR                             ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;

Member

uPhyId

Der Bezeichner (ID) des PHY, den die 802.11-Station zum Erkennen des BSS-Netzwerks verwendet hat. Die PHY-ID ist der Index innerhalb der Liste der unterstützten PHYs, die vom Treiber über eine Abfrage von OID_DOT11_SUPPORTED_PHY_TYPES zurückgegeben werden.

Diese ID darf nicht DOT11_PHY_ID_ANY werden.

PhySpecificInfo

Die Attribute des PHY, auf das vom uPhyId-Element verwiesen wird. PhySpecificInfo ist als ein Format formatiert. DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO Union.

dot11BSSID

Die Adresse der Medienzugriffskontrolle (MAC) des Zugriffspunkts (AP) (für Infrastruktur BSS-Netzwerke) oder Peerstation (für unabhängige BSS-Netzwerke), die den 802.11 Beacon- oder Probe Response-Frame gesendet hat, der vom 802.11-Station beim Scannen empfangen wurde. Der Datentyp für dieses Element ist die DOT11_MAC_ADDRESS Struktur.

dot11BSSType

Der BSS-Netzwerktyp.

Der Datentyp für dieses Element ist die DOT11_BSS_TYPE Enumeration. Der Miniporttreiber darf dieses Element nicht auf den dot11_BSS_type_any Wert festlegen.

lRSSI

Der Empfangene Signalstärkeindikator (RSSI) in Einheiten von Dezibeln, auf die auf 1,0 Milliwatt (dBm) verwiesen wird, wie von der Station 802.11 für die AP oder Peerstation festgestellt.

uLinkQuality

Der Verbindungsqualitätswert reicht von 0 bis 100. Ein Wert von 100 gibt die höchste Verbindungsqualität an. Weitere Informationen zur Bestimmung der Linkqualität finden Sie unter Link Quality Operations.

bInRegDomain

Dieses Mitglied gibt an, ob die AP- oder Peerstation innerhalb der behördlichen Domäne ausgeführt wird, wie durch die Eingabelandzeichenfolge identifiziert. Um dieses Element festzulegen, muss der Miniporttreiber die folgenden Richtlinien verwenden:

  • Wenn die 802.11-Station mehrere regulatorische Domänen nicht unterstützt, legen Sie das Element auf TRUE fest. Weitere Informationen zu mehreren regulatorischen Domänen finden Sie unter OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
  • Wenn die Eingabelandzeichenfolge alle Nullen ist, legen Sie das Element auf TRUE fest.
  • Wenn die AP- oder Peerstation nicht auf einem Kanal ausgeführt wird, der für die durch die Eingabelandzeichenfolge angegebene regulatorische Domäne gültig ist, legen Sie das Element auf FALSE fest.
  • Wenn der 802.11 Beacon- oder Probe Response-Frame, der von der AP- oder Peerstation empfangen wurde, kein Landinformationselement (Country Information Element, IE) enthält, legen Sie das Element auf TRUE fest.

    Weitere Informationen zum Länder-IE finden Sie unter Klausel 7.3.2.12 des IEEE 802.11d-2001-Standards.

  • Wenn der 802.11 Beacon- oder Probe Response-Frame, der von der AP- oder Peerstation empfangen wurde, einen Land-IE enthält, legen Sie das Element auf FALSE fest, wenn der Wert des Länderzeichenfolgenunterfelds nicht der Eingabelandzeichenfolge entspricht.
  • Legen Sie das Element in allen anderen Fällen auf TRUE fest.

usBeaconPeriod

Der Wert des Beacon-Intervallfelds aus dem 802.11 Beacon- oder Probe Response-Frame.

ullTimestamp

Der Wert des Timestamp-Felds aus dem 802.11 Beacon- oder Probe Response-Frame.

ullHostTimestamp

Der Zeitstempel wurde durch einen Aufruf von NdisGetCurrentSystemTime aufgelöst, der erfasst, wann die 802.11-Station den 802.11 Beacon- oder Probe Response-Frame empfangen hat.

usCapabilityInformation

Der Wert des Felds "Funktionsinformationen" aus dem 802.11 Beacon- oder Probe Response-Frame.

uBufferLength

Die Länge des ucBuffer-Arrays in Bytes in der DOT11_BSS_ENTRY Struktur. ulBufferLength muss die genaue Länge der Daten im ucBuffer-Array sein und darf keinen Abstand für die Ausrichtung enthalten.

ucBuffer[1]

Die Informationselemente (Variable-Length Information Elements, IEs) aus den 802.11 Beacon- oder Probe Response-Frames. Für jeden BSS müssen die IEs vom letzten Beacon- oder Probe Response-Frame stammen, der von diesem BSS-Netzwerk empfangen wurde. Wenn ein IE nur in einem Frame verfügbar ist, muss der Miniporttreiber den IE mit den anderen IEs aus dem letzten empfangenen Beacon- oder Probe Response-Frame zusammenführen.

Wenn sich die NIC im Extensible Access Point (ExtAP)-OP-Modus befindet, sollte die BSS-Liste einen Eintrag für die BSS enthalten, die die NIC erstellt hat.

Weitere Informationen zu den Feldern innerhalb von IEEE 802.11 Beacon- oder Probe Response-Frames finden Sie in Klausel 8.4 des IEEE 802.11-2012-Standards.

Bemerkungen

Wenn die 802.11-Station einen Scanvorgang ausführt, speichert der native 802.11-Miniporttreiber die empfangenen 802.11 Beacon- und Probe Response-Frames zwischen. Weitere Informationen zum Scanvorgang finden Sie unter Native 802.11 Scan Operations.

Nachdem die Station 802.11 den Scanvorgang abgeschlossen hat, gibt der Miniporttreiber die Liste der zwischengespeicherten Beacon- und Probeantwortframes zurück, wenn sie von OID_DOT11_ENUM_BSS_LIST abgefragt werden. Eine separate DOT11_BSS_ENTRY Struktur wird für jeden Beacon- und Probe Response-Frame formatiert.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und späteren Versionen der Windows-Betriebssysteme.
Header windot11.h (einschließlich Ndis.h)

Weitere Informationen

DOT11_BSS_TYPE

DOT11_BSS_LIST

OID_DOT11_SUPPORTED_PHY_TYPES

OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED

DOT11_MAC_ADDRESS

DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO

NdisGetCurrentSystemTime

OID_DOT11_ENUM_BSS_LIST