DOT11_BSS_ENTRY-Struktur (windot11.h)
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 Station 802.11 zum Erkennen des BSS-Netzwerks verwendet hat. Die PHY-ID ist der Index in 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 formatiert DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO Union.
dot11BSSID
Die MAC-Adresse (Media Access Control) des Zugriffspunkts (AP) (für BSS-Infrastrukturnetzwerke) oder Peerstation (für unabhängige BSS-Netzwerke), die den 802.11 Beacon- oder Probe Response-Frame gesendet hat, der von der 802.11-Station beim Scannen empfangen wurde. Der Datentyp für diesen Member ist die DOT11_MAC_ADDRESS-Struktur .
dot11BSSType
Der BSS-Netzwerktyp.
Der Datentyp für diesen Member ist die DOT11_BSS_TYPE-Enumeration . Der Miniporttreiber darf diesen Member nicht auf den dot11_BSS_type_any-Wert festlegen.
lRSSI
Der RSSI-Wert (Received Signal Strength Indicator) in Einheiten von Dezibel, auf die auf 1,0 Milliwatt (dBm) verwiesen wird, wie von der 802.11-Station für die AP- oder Peerstation erkannt.
uLinkQuality
Der Wert der Linkqualität zwischen 0 und 100. Der Wert 100 gibt die höchste Linkqualität an. Weitere Informationen zum Bestimmen der Linkqualität finden Sie unter Verbindungsqualitätsvorgänge.
bInRegDomain
Dieses Mitglied gibt an, ob der AP oder die Peerstation innerhalb der gesetzlichen Domäne ausgeführt wird, die durch die Eingabelandzeichenfolge identifiziert wird. 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 nullen ist, legen Sie den Member auf TRUE fest.
- Wenn der AP oder die Peerstation nicht in einem Kanal ausgeführt wird, der für die durch die Eingabelandzeichenfolge angegebene regulatorische Domäne gültig ist, legen Sie den Member auf FALSE fest.
-
Wenn der 802.11 Beacon- oder Probe Response-Frame, der von der AP- oder Peerstation empfangen wurde, kein Country Information Element (IE) enthält, legen Sie das Element auf TRUE fest.
Weitere Informationen zum Country 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 Country IE enthält, legen Sie das Element auf FALSE fest, wenn der Wert des Unterfelds Country String nicht der Eingabelandzeichenfolge entspricht.
- Legen Sie das Element in allen anderen Fällen auf TRUE fest.
usBeaconPeriod
Der Wert des Felds Beaconintervall aus dem 802.11 Beacon- oder Probe Response-Frame.
ullTimestamp
Der Wert des Zeitstempelfelds aus dem 802.11 Beacon- oder Probe Response-Frame.
ullHostTimestamp
Der Zeitstempel, aufgelöst durch einen Aufruf von NdisGetCurrentSystemTime, der aufzeichnet, wann die 802.11-Station den 802.11 Beacon- oder Testantwortframe 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 aufweisen und darf keinen Abstand für die Ausrichtung enthalten.
ucBuffer[1]
Die Informationselemente mit variabler Länge (IEs) aus dem 802.11 Beacon- oder Probe Response-Frames. Für jede BSS müssen die IEs vom letzten Beacon- oder Testantwortframe 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 Testantwortframe zusammenführen.
Wenn sich die NIC im OP-Modus Extensible Access Point (Extensible Access Point) befindet, sollte die BSS-Liste einen Eintrag für die von der NIC erstellte BSS enthalten.
Weitere Informationen zu den Feldern in IEEE 802.11 Beacon- oder Probe Response-Frames finden Sie in Klausel 8.4 des IEEE 802.11-2012-Standards.
Hinweise
Wenn die Station 802.11 einen Scanvorgang ausführt, speichert der Native 802.11-Miniporttreiber die empfangenen 802.11 Beacon- und Testantwortframes zwischen. Weitere Informationen zum Scanvorgang finden Sie unter Native 802.11-Scanvorgänge.
Nachdem die 802.11-Station den Scanvorgang abgeschlossen hat, gibt der Miniporttreiber die Liste der zwischengespeicherten Beacon- und Testantwortframes zurück, wenn er von OID_DOT11_ENUM_BSS_LIST abgefragt wird. Für jeden Beacon- und Testantwortframe ist eine separate DOT11_BSS_ENTRY-Struktur formatiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Kopfzeile | windot11.h (include Ndis.h) |