DOT11_STATISTICS-Struktur (windot11.h)

Artikel
08/08/2023

Wichtig Die native WLAN-Schnittstelle 802.11 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 driver model.

Die DOT11_STATISTICS-Struktur zeichnet statistische Indikatoren für die 802.11-Schnittstelle auf.

Syntax

typedef struct DOT11_STATISTICS {
  NDIS_OBJECT_HEADER         Header;
  ULONGLONG                  ullFourWayHandshakeFailures;
  ULONGLONG                  ullTKIPCounterMeasuresInvoked;
  ULONGLONG                  ullReserved;
  DOT11_MAC_FRAME_STATISTICS MacUcastCounters;
  DOT11_MAC_FRAME_STATISTICS MacMcastCounters;
  DOT11_PHY_FRAME_STATISTICS PhyCounters[1];
} DOT11_STATISTICS, *PDOT11_STATISTICS;

Member

Header

Typ, Revision und Größe der DOT11_STATISTICS-Struktur. Dieser Member 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_STATISTICS_REVISION_1 festgelegt werden.

Size

Dieser Member muss auf sizeof(DOT11_STATISTICS)festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

ullFourWayHandshakeFailures

Die Anzahl von Vier-Wege-Handshakefehlern, die bei der 802.11-Station während Wi-Fi WPA- oder RSNA-Authentifizierung (Robust Security Network Association) aufgetreten sind.

Wenn die 802.11-Station die WPA- oder RSNA-Authentifizierung nicht ausführt, sollte dieser Member auf DOT11_STATISTICS_UNKNOWN festgelegt werden.

ullTKIPCounterMeasuresInvoked

Die Anzahl der Aufrufe der 802.11-Station nach einem Mic-Fehler (Message Integrity Code).

Wenn die 802.11-Station keine TKIP-Gegenmaßnahmen ausführt, sollte sie diesen Member auf DOT11_STATISTICS_UNKNOWN festlegen.

ullReserved

Dieser Member ist für die Verwendung durch das Betriebssystem reserviert. Der Miniporttreiber darf nicht in diesen Member schreiben.

MacUcastCounters

Die Leistungsindikatoren der MAC-Ebene basieren auf Unicastpaketen, die von der Station 802.11 gesendet oder empfangen werden. Die Datenstruktur für dieses Element ist die DOT11_MAC_FRAME_STATISTICS Struktur.

Hinweis

Leistungsindikatoren für empfangene Unicastpakete dürfen nur für pakete mit einer MAC-Zieladresse im MAC-Header 802.11 erhöht werden, die der MAC-Adresse der 802.11-Station entspricht.

MacMcastCounters

Die Leistungsindikatoren der MAC-Ebene basieren auf Multicast- oder Broadcastpaketen, die von der 802.11-Station gesendet oder empfangen werden. Die Datenstruktur für dieses Element ist die DOT11_MAC_FRAME_STATISTICS Struktur.

Hinweis

Leistungsindikatoren für empfangene Multicast- oder Broadcastpakete dürfen nur für pakete mit einer MAC-Zieladresse im MAC-Header 802.11 erhöht werden, die mit einem Eintrag in der Multicastadressenliste der 802.11-Station übereinstimmt. Weitere Informationen zur Multicastadressenliste finden Sie unter OID_DOT11_MULTICAST_LIST.

PhyCounters[1]

Ein Array von PHY-Ebenenindikatoren. Jeder Eintrag in diesem Array ist als DOT11_PHY_FRAME_STATISTICS Struktur.

Der Miniporttreiber muss einen Eintrag innerhalb des PhyCounters-Arrays für jeden unterstützten PHY verwalten. Wenn die 802.11-Station mehrere PHYs desselben Typs unterstützt, muss der Miniporttreiber für jeden einzelne Einträge erstellen.

Einträge innerhalb des PhyCounters-Arrays müssen sich in derselben Reihenfolge wie die Liste der unterstützten PHYs befinden, die der Treiber zurückgibt, wenn er von abgefragt wird. OID_DOT11_SUPPORTED_PHY_TYPES.

Hinweise

Der Miniporttreiber muss alle Leistungsindikatoren in der DOT11_STATISTICS-Struktur bedingungslos auf Null festlegen, einschließlich DER LEISTUNGSindikatoren für MAC- und PHY-Ebenen, wenn einer der folgenden Probleme auftritt:

Die MiniportInitializeEx-Funktion des Treibers wird aufgerufen.
Die MiniportOidRequest-Funktion des Treibers wird mit einer OID-Set-Anforderung von OID_DOT11_RESET_REQUEST aufgerufen, unabhängig vom Typ des in der Set-Anforderung angegebenen Zurücksetzungsvorgangs.

Weitere Informationen zu den Statistiken, die von einem nativen 802.11-Miniporttreiber erfasst werden, finden Sie unter Native 802.11-Statistiken.

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)

Weitere Informationen

OID_DOT11_STATISTICS

Freigeben über