DOT11_STATISTICS-Struktur (windot11.h)
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.
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.
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.
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) |