struttura DOT11_MAC_FRAME_STATISTICS (windot11.h)
Importante
WiFiCx è il nuovo modello di driver Wi-Fi rilasciato in Windows 11. Ti consigliamo di usare WiFiCx per sfruttare le funzionalità più recenti. Il modello di driver WDI è ora in modalità di manutenzione e riceverà solo correzioni ad alta priorità.
La struttura DOT11_MAC_FRAME_STATISTICS registra i contatori statistici per il sottostrato IEEE media access control (MAC) della stazione 802.11.
Sintassi
typedef struct DOT11_MAC_FRAME_STATISTICS {
ULONGLONG ullTransmittedFrameCount;
ULONGLONG ullReceivedFrameCount;
ULONGLONG ullTransmittedFailureFrameCount;
ULONGLONG ullReceivedFailureFrameCount;
ULONGLONG ullWEPExcludedCount;
ULONGLONG ullTKIPLocalMICFailures;
ULONGLONG ullTKIPReplays;
ULONGLONG ullTKIPICVErrorCount;
ULONGLONG ullCCMPReplays;
ULONGLONG ullCCMPDecryptErrors;
ULONGLONG ullWEPUndecryptableCount;
ULONGLONG ullWEPICVErrorCount;
ULONGLONG ullDecryptSuccessCount;
ULONGLONG ullDecryptFailureCount;
} DOT11_MAC_FRAME_STATISTICS, *PDOT11_MAC_FRAME_STATISTICS;
Membri
ullTransmittedFrameCount
Numero di pacchetti di unità dati del servizio MAC (MSDU) e frame MMPDU (Mac Management Protocol Data Unit) trasmessi correttamente dal sottostrato IEEE MAC della stazione 802.11.
ullReceivedFrameCount
Numero di pacchetti MSDU e frame MMPDU ricevuti correttamente dal sottostrato IEEE MAC della stazione 802.11. Questo membro non deve essere incrementato per i pacchetti ricevuti che non sono riusciti a decrittografare la crittografia o la convalida MIC.
ullTransmittedFailureFrameCount
Numero di pacchetti MSDU e frame MMPDU che il sottostrato IEEE MAC della stazione 802.11 non è riuscito a trasmettere correttamente.
ullReceivedFailureFrameCount
Numero di pacchetti MSDU e frame MMPDU che il sottostrato IEEE MAC della stazione 802.11 non è riuscito a ricevere correttamente.
ullWEPExcludedCount
Numero di frame MPDU (UnenCrypted Received Protocol Data Unit) rimossi dal sottostrato MAC quando l'oggetto IEEE 802.11 dot11ExcludeUnencrypted l'oggetto MIB (Management Information Base). Per altre informazioni su questo oggetto MIB, vedere OID_DOT11_EXCLUDE_UNENCRYPTED.
I fotogrammi MPDU vengono considerati non crittografati quando il sottocampo Frame protetto del campo Controllo frame nell'intestazione MAC IEEE 802.11 è impostato su zero.
ullTKIPLocalMICFailures
Numero di pacchetti MSDU ricevuti rimossi dalla stazione 802.11 a causa di errori MIC.
ullTKIPReplays
Numero di fotogrammi MPDU ricevuti eliminati dalla stazione 802.11 a causa della procedura di protezione della riproduzione TKIP.
ullTKIPICVErrorCount
Numero di frame MPDU crittografati che la stazione 802.11 non è riuscita a decrittografare a causa di un errore ICV TKIP.
ullCCMPReplays
Numero di fotogrammi MPDU ricevuti rimossi dalla stazione 802.11 a causa della procedura di protezione della riproduzione AES-CCMP.
ullCCMPDecryptErrors
Numero di fotogrammi MPDU ricevuti rimossi dalla stazione 802.11 a causa di errori rilevati dall'algoritmo di decrittografia AES-CCMP.
ullWEPUndecryptableCount
Numero di fotogrammi MPDU crittografati ricevuti per cui non era disponibile una chiave di decrittografia WEP nella stazione 802.11.
ullWEPICVErrorCount
Numero di frame MPDU crittografati che la stazione 802.11 non è riuscita a decrittografare a causa di un errore ICV WEP.
ullDecryptSuccessCount
Numero di pacchetti crittografati ricevuti decrittografati correttamente dalla stazione 802.11.
Per gli algoritmi di crittografia WEP e TKIP, il driver miniport deve incrementare questo contatore per ogni MPDU crittografato ricevuto che è stato decrittografato correttamente. Per l'algoritmo di crittografia AES-CCMP, il driver miniport deve incrementare questo contatore in ogni pacchetto MSDU crittografato ricevuto che è stato decrittografato correttamente.
ullDecryptFailureCount
Numero di pacchetti crittografati che la stazione 802.11 non è riuscita a decrittografare.
Per gli algoritmi di crittografia WEP e TKIP, il driver miniport deve incrementare questo contatore per ogni MPDU crittografato ricevuto che non è stato decrittografato correttamente. Per l'algoritmo di crittografia AES-CCMP, il driver miniport deve incrementare questo contatore in ogni pacchetto MSDU crittografato ricevuto che non è stato decrittografato correttamente.
Il driver miniport non deve incrementare questo contatore per i pacchetti decrittografati correttamente, ma vengono rimossi per altri motivi. Ad esempio, il driver miniport non deve incrementare questo contatore per i pacchetti eliminati a causa di errori MIC TKIP o riproduzioni TKIP/CCMP.
Osservazioni
I membri della struttura DOT11_MAC_STATISTICS vengono usati per registrare le statistiche a livello MAC per:
- Pacchetti MSDU 802.11.
- Fotogrammi MMPDU 802.11.
- Fotogrammi MPDU 802.11. I contatori dei frame MPDU devono includere tutti i frammenti MPDU inviati per un pacchetto MSDU o un frame MMPDU
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| intestazione | windot11.h (include Ndis.h) |