DOT11_STATISTICS struttura (windot11.h)
La struttura DOT11_STATISTICS registra i contatori statistici per l'interfaccia 802.11.
Sintassi
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;
Members
Header
Tipo, revisione e dimensione della struttura DOT11_STATISTICS. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .
Il driver miniport deve impostare i membri di Intestazione sui valori seguenti:
Tipo
Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.
Revisione
Questo membro deve essere impostato su DOT11_STATISTICS_REVISION_1.
Dimensione
Questo membro deve essere impostato su sizeof(DOT11_STATISTICS).
Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.
ullFourWayHandshakeFailures
Numero di errori di handshake a quattro vie rilevati dalla stazione 802.11 durante Wi-Fi l'autenticazione WPA (Protected Access) o Robust Security Network Association (RSNA).
Se la stazione 802.11 non esegue l'autenticazione WPA o RSNA, deve impostare questo membro su DOT11_STATISTICS_UNKNOWN.
ullTKIPCounterMeasuresInvoked
Numero di volte in cui la stazione 802.11 ha richiamato le contromisure in seguito a un errore di codice di integrità del messaggio (MIC).
Se la stazione 802.11 non esegue contromisure TKIP, deve impostare questo membro su DOT11_STATISTICS_UNKNOWN.
ullReserved
Questo membro è riservato per l'uso dal sistema operativo. Il driver miniport non deve scrivere in questo membro.
MacUcastCounters
I contatori del livello MAC basati su pacchetti unicast inviati o ricevuti dalla stazione 802.11. La struttura dei dati per questo membro è la DOT11_MAC_FRAME_STATISTICS struttura.
I contatori per i pacchetti unicast ricevuti devono essere incrementati solo per tali pacchetti con un indirizzo MAC di destinazione nell'intestazione MAC 802.11 corrispondente all'indirizzo MAC della stazione 802.11.
MacMcastCounters
I contatori del livello MAC basati su pacchetti multicast o trasmissione inviati o ricevuti dalla stazione 802.11. La struttura dei dati per questo membro è la DOT11_MAC_FRAME_STATISTICS struttura.
I contatori per i pacchetti multicast o broadcast ricevuti devono essere incrementati solo per tali pacchetti con un indirizzo MAC di destinazione nell'intestazione MAC 802.11 che corrisponde a una voce nell'elenco indirizzi multicast della stazione 802.11. Per altre informazioni sull'elenco di indirizzi multicast, vedere OID_DOT11_MULTICAST_LIST.
PhyCounters[1]
Matrice di contatori del livello PHY. Ogni voce in questa matrice viene formattata come DOT11_PHY_FRAME_STATISTICS struttura.
Il driver miniport deve mantenere una voce all'interno della matrice PhyCounters per ogni PHY supportato. Se la stazione 802.11 supporta più PHY dello stesso tipo, il driver miniport deve creare voci separate per ognuna.
Le voci all'interno della matrice PhyCounters devono trovarsi nello stesso ordine dell'elenco dei PHY supportati restituiti dal driver quando viene eseguita una query OID_DOT11_SUPPORTED_PHY_TYPES.
Commenti
Il driver miniport deve impostare in modo incondizionato tutti i contatori nella struttura DOT11_STATISTICS su zero, inclusi i contatori MAC-layer e PHY, quando si verifica uno dei seguenti:
- Viene chiamata la funzione MiniportInitializeEx del driver.
- La funzione MiniportOidRequest del driver viene chiamata con una richiesta di set OID di OID_DOT11_RESET_REQUEST, indipendentemente dal tipo di operazione di reimpostazione specificata nella richiesta impostata.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| Intestazione | windot11.h (include Ndis.h) |