struttura DOT11_STATISTICS (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;
Membri
Header
Tipo, revisione e dimensioni della struttura DOT11_STATISTICS. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER.
Il driver miniport deve impostare i membri di Header sui valori seguenti:
Digitare
Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.
Revisione
Questo membro deve essere impostato su DOT11_STATISTICS_REVISION_1.
Grandezza
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 l'autenticazione di Wi-Fi Protected Access (WPA) o RSNA (Robust Security Network Association).
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 contromisure in seguito a un errore del codice di integrità del messaggio.
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 è 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 broadcast inviati o ricevuti dalla stazione 802.11. La struttura dei dati per questo membro è 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 di 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 è 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 essere nello stesso ordine dell'elenco dei phY supportati restituiti dal driver quando viene eseguita una query da OID_DOT11_SUPPORTED_PHY_TYPES.
Osservazioni
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 set.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| intestazione | windot11.h (include Ndis.h) |