struttura DOT11_PHY_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_PHY_FRAME_STATISTICS registra i contatori statistici per il livello fisico IEEE (PHY) della stazione 802.11.
Sintassi
typedef struct DOT11_PHY_FRAME_STATISTICS {
ULONGLONG ullTransmittedFrameCount;
ULONGLONG ullMulticastTransmittedFrameCount;
ULONGLONG ullFailedCount;
ULONGLONG ullRetryCount;
ULONGLONG ullMultipleRetryCount;
ULONGLONG ullMaxTXLifetimeExceededCount;
ULONGLONG ullTransmittedFragmentCount;
ULONGLONG ullRTSSuccessCount;
ULONGLONG ullRTSFailureCount;
ULONGLONG ullACKFailureCount;
ULONGLONG ullReceivedFrameCount;
ULONGLONG ullMulticastReceivedFrameCount;
ULONGLONG ullPromiscuousReceivedFrameCount;
ULONGLONG ullMaxRXLifetimeExceededCount;
ULONGLONG ullFrameDuplicateCount;
ULONGLONG ullReceivedFragmentCount;
ULONGLONG ullPromiscuousReceivedFragmentCount;
ULONGLONG ullFCSErrorCount;
} DOT11_PHY_FRAME_STATISTICS, *PDOT11_PHY_FRAME_STATISTICS;
Membri
ullTransmittedFrameCount
Numero di pacchetti MSDU e frame MMPDU trasmessi correttamente dal livello IEEE PHY della stazione 802.11.
ullMulticastTransmittedFrameCount
Numero di pacchetti MSDU multicast o broadcast e fotogrammi MMPDU trasmessi correttamente dal livello IEEE PHY della stazione 802.11.
ullFailedCount
Numero di pacchetti MSDU e frame MMPDU che la stazione 802.11 non è riuscita a trasmettere dopo aver superato i limiti di ripetizione definiti dai contatori IEEE 802.11 IEEE dot11ShortRetryLimit o dot11LongRetryLimit contatori MIB. Per altre informazioni su questi contatori MIB, vedere OID_DOT11_SHORT_RETRY_LIMIT o OID_DOT11_LONG_RETRY_LIMIT.
ullRetryCount
Numero di pacchetti MSDU e fotogrammi MMPDU trasmessi correttamente dalla stazione 802.11 dopo uno o più tentativi.
ullMultipleRetryCount
Numero di pacchetti MSDU e frame MMPDU trasmessi correttamente dalla stazione 802.11 dopo più tentativi di ritrasmissione.
Per i pacchetti MSDU, il driver miniport deve incrementare questo contatore per ogni pacchetto trasmesso correttamente dopo una o più frammenti MPDU necessari per la ritrasmissione.
ullMaxTXLifetimeExceededCount
Numero di pacchetti MSDU e frame MMPDU che la stazione 802.11 non è riuscita a trasmettere a causa di un timeout definito dall'IEEE 802.11 dot11MaxTransmitMSDULifetime oggetto MIB. Per altre informazioni su questo oggetto MIB, vedere OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.
ullTransmittedFragmentCount
Numero di fotogrammi MPDU trasmessi e riconosciuti dalla stazione 802.11 tramite un frame ACK ricevuto 802.11.
ullRTSSuccessCount
Numero di volte in cui la stazione 802.11 ha ricevuto un frame Clear To Send (CTS) in risposta a un frame Request To Send (RTS).
ullRTSFailureCount
Numero di volte in cui la stazione 802.11 non ha ricevuto un frame CTS in risposta a un telaio RTS.
ullACKFailureCount
Numero di volte in cui la stazione 802.11 si aspettava e non riceveva un frame Acknowledgement (ACK).
ullReceivedFrameCount
Numero totale di pacchetti MSDU e fotogrammi MMPDU ricevuti correttamente dalla stazione 802.11.
Per i pacchetti MSDU, il driver miniport deve incrementare questo contatore per ogni pacchetto i cui frammenti MPDU sono stati ricevuti e superati la verifica della sequenza di controllo dei fotogrammi e il rilevamento della riproduzione. Il driver miniport deve incrementare questo membro indipendentemente dal fatto che il pacchetto MSDU ricevuto o il frammento MPDU non riescano la decrittografia della crittografia a livello MAC.
Questo contatore è facoltativo. Se la scheda di interfaccia di rete non supporta questo contatore, il driver miniport deve impostare questo membro su DOT11_STATISTICS_UNKNOWN.
ullMulticastReceivedFrameCount
Numero di pacchetti MSDU multicast o broadcast e fotogrammi MMPDU ricevuti correttamente dalla stazione 802.11.
Per i pacchetti MSDU, il driver miniport deve incrementare questo contatore per ogni pacchetto i cui frammenti MPDU sono stati ricevuti e superati il rilevamento della verifica e della riproduzione del cluster di failover. Il driver miniport deve incrementare questo membro indipendentemente dal fatto che il pacchetto MSDU ricevuto o il frammento MPDU non riescano la decrittografia della crittografia a livello MAC.
Questo contatore è facoltativo. Se la scheda di interfaccia di rete non supporta questo contatore, il driver miniport deve impostare questo membro su DOT11_STATISTICS_UNKNOWN.
ullPromiscuousReceivedFrameCount
Numero di pacchetti MSDU o fotogrammi MMPDU ricevuti dalla stazione 802.11 quando è abilitato un filtro di pacchetti promiscuo. Per altre informazioni sui filtri di pacchetti, vedere OID_GEN_CURRENT_PACKET_FILTER.
Se è abilitato un filtro di pacchetti promiscuo, il driver miniport deve incrementare solo questo contatore per i pacchetti MSDU ricevuti o i frame MMPDU che sarebbero stati rifiutati se il filtro non fosse abilitato. Il driver non deve incrementare questo contatore per:
- Pacchetti MSDU unicast o fotogrammi MMPDU con un indirizzo MAC di destinazione corrispondente all'indirizzo MAC della stazione 802.11.
- Pacchetti MSDU multicast o broadcast o fotogrammi MMPDU con un indirizzo MAC di destinazione corrispondente 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.
ullMaxRXLifetimeExceededCount
Numero se pacchetti MSDU e fotogrammi MMPDU eliminati dalla stazione 802.11 a causa di un timeout definito dall'oggetto IEEE 802.11 dot11MaxReceiveLifetime oggetto MIB. Per altre informazioni su questo oggetto MIB, vedere OID_DOT11_MAX_RECEIVE_LIFETIME.
ullFrameDuplicateCount
Numero di fotogrammi MPDU duplicati ricevuti dalla stazione 802.11. La stazione 802.11 determina fotogrammi duplicati tramite il campo Controllo sequenza dell'intestazione MAC 802.11.
ullReceivedFragmentCount
Numero di fotogrammi MPDU ricevuti dalla stazione 802.11 per pacchetti MSDU o fotogrammi MMPDU.
ullPromiscuousReceivedFragmentCount
Numero di fotogrammi MPDU ricevuti dalla stazione 802.11 per pacchetti MSDU o fotogrammi MMPDU quando è stato abilitato un filtro di pacchetti promiscuo. Per altre informazioni sui filtri di pacchetti, vedere OID_GEN_CURRENT_PACKET_FILTER.
Se è abilitato un filtro di pacchetti promiscuo, il driver miniport deve incrementare solo questo contatore per i fotogrammi MPDU ricevuti che sarebbero stati rifiutati se il filtro non fosse abilitato. Il driver non deve incrementare questo contatore per:
- Fotogrammi MPDU unicast con un indirizzo MAC di destinazione che corrisponde all'indirizzo MAC della stazione 802.11.
- Fotogrammi MPDU multicast o broadcast con un indirizzo MAC di destinazione corrispondente 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.
ullFCSErrorCount
Numero di fotogrammi MPDU ricevuti dalla stazione 802.11 con errori FCS.
Osservazioni
I membri di questa struttura vengono utilizzati per registrare le statistiche a livello di PHY 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) |