DOT11_PHY_FRAME_STATISTICS-Struktur (windot11.h)
Syntax
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;
Member
ullTransmittedFrameCount
Die Anzahl der MSDU-Pakete und MMPDU-Frames, die die IEEE PHY-Schicht der 802.11-Station erfolgreich übertragen hat.
ullMulticastTransmittedFrameCount
Die Anzahl der Multicast- oder Broadcast-MSDU-Pakete und MMPDU-Frames, die die IEEE PHY-Schicht der 802.11-Station erfolgreich übertragen hat.
ullFailedCount
Die Anzahl der MSDU-Pakete und MMPDU-Frames, die von der 802.11-Station nicht übertragen werden konnten, nachdem die durch die MIB-Indikatoren 802.11 IEEE dot11ShortRetryLimit oder dot11LongRetryLimit definierten Wiederholungsgrenzwerte überschritten wurden. Weitere Informationen zu diesen MIB-Indikatoren finden Sie unter OID_DOT11_SHORT_RETRY_LIMIT oder OID_DOT11_LONG_RETRY_LIMIT.
ullRetryCount
Die Anzahl der MSDU-Pakete und MMPDU-Frames, die die Station 802.11 nach mindestens einem Versuch erfolgreich übertragen hat.
ullMultipleRetryCount
Die Anzahl der MSDU-Pakete und MMPDU-Frames, die die Station 802.11 nach mehr als einem Erneutübertragungsversuch erfolgreich übertragen hat.
Bei MSDU-Paketen muss der Miniporttreiber diesen Leistungsindikator für jedes Paket erhöhen, das erfolgreich übertragen wurde, nachdem mindestens eines seiner MPDU-Fragmente erneut übertragen wurde.
ullMaxTXLifetimeExceededCount
Die Anzahl der MSDU-Pakete und MMPDU-Frames, die die 802.11-Station aufgrund eines Timeouts nicht übertragen konnte, wie durch das MIB-Objekt IEEE 802.11 dot11MaxTransmitMSDULifetime definiert. Weitere Informationen zu diesem MIB-Objekt finden Sie unter OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.
ullTransmittedFragmentCount
Die Anzahl der MPDU-Frames, die die 802.11-Station über einen empfangenen 802.11 ACK-Frame übertragen und bestätigt hat.
ullRTSSuccessCount
Gibt an, wie oft die 802.11-Station als Reaktion auf einen RTS-Frame (Request To Send) einen CTS-Frame (Clear To Send) empfangen hat.
ullRTSFailureCount
Die Häufigkeit, mit der die 802.11-Station als Reaktion auf einen RTS-Frame keinen CTS-Frame empfangen hat.
ullACKFailureCount
Die Anzahl der Male, die die 802.11-Station erwartet hat und keinen Bestätigungsrahmen (ACK) erhalten hat.
ullReceivedFrameCount
Die Gesamtzahl der MSDU-Pakete und MMPDU-Frames, die die Station 802.11 erfolgreich empfangen hat.
Bei MSDU-Paketen muss der Miniporttreiber diesen Leistungsindikator für jedes Paket erhöhen, dessen MPDU-Fragmente empfangen und die FCS-Überprüfungs- und Wiedergabeerkennung (Frame Check Sequence) übergeben wurden. Der Miniporttreiber muss diesen Member erhöhen, unabhängig davon, ob das empfangene MSDU-Paket oder das MPDU-Fragment die Verschlüsselung auf MAC-Ebene nicht entschlüsselt.
Dieser Indikator ist optional. Wenn die NIC diesen Leistungsindikator nicht unterstützt, sollte der Miniporttreiber diesen Member auf DOT11_STATISTICS_UNKNOWN festlegen.
ullMulticastReceivedFrameCount
Die Anzahl der Multicast- oder Broadcast-MSDU-Pakete und MMPDU-Frames, die die Station 802.11 erfolgreich empfangen hat.
Bei MSDU-Paketen muss der Miniporttreiber diesen Indikator für jedes Paket erhöhen, dessen MPDU-Fragmente empfangen und die FCS-Überprüfung und Wiedergabeerkennung bestanden haben. Der Miniporttreiber muss diesen Member erhöhen, unabhängig davon, ob das empfangene MSDU-Paket oder das MPDU-Fragment die Verschlüsselung auf MAC-Ebene nicht entschlüsselt.
Dieser Indikator ist optional. Wenn die NIC diesen Leistungsindikator nicht unterstützt, sollte der Miniporttreiber diesen Member auf DOT11_STATISTICS_UNKNOWN festlegen.
ullPromiscuousReceivedFrameCount
Die Anzahl der MSDU-Pakete oder MMPDU-Frames, die von der 802.11-Station empfangen werden, wenn ein promiskbarer Paketfilter aktiviert ist. Weitere Informationen zu Paketfiltern finden Sie unter OID_GEN_CURRENT_PACKET_FILTER.
Wenn ein Promiscuous-Paketfilter aktiviert ist, darf der Miniporttreiber diesen Indikator nur für empfangene MSDU-Pakete oder MMPDU-Frames erhöhen, die bei nicht aktiviertem Filter abgelehnt worden wären. Der Treiber darf diesen Indikator nicht inkrementieren für:
- Unicast-MSDU-Pakete oder MMPDU-Frames mit einer MAC-Zieladresse, die der MAC-Adresse der 802.11-Station entspricht.
- Multicast oder Übertragen von MSDU-Paketen oder MMPDU-Frames mit einer MAC-Zieladresse, die mit einem Eintrag in der Multicastadressenliste der 802.11-Station übereinstimmt. Weitere Informationen zur Multicastadressenliste finden Sie unter OID_DOT11_MULTICAST_LIST.
ullMaxRXLifetimeExceededCount
Die Zahl, wenn MSDU-Pakete und MMPDU-Frames, die die 802.11-Station aufgrund eines Timeouts verworfen hat, wie durch das IEEE 802.11 dot11MaxReceiveLifetime MIB-Objekt definiert. Weitere Informationen zu diesem MIB-Objekt finden Sie unter OID_DOT11_MAX_RECEIVE_LIFETIME.
ullFrameDuplicateCount
Die Anzahl doppelter MPDU-Frames, die die Station 802.11 empfangen hat. Die 802.11-Station bestimmt doppelte Frames über das Feld Sequenzsteuerung des MAC-Headers 802.11.
ullReceivedFragmentCount
Die Anzahl der MPDU-Frames, die von der 802.11-Station für MSDU-Pakete oder MMPDU-Frames empfangen werden.
ullPromiscuousReceivedFragmentCount
Die Anzahl der MPDU-Frames, die von der 802.11-Station für MSDU-Pakete oder MMPDU-Frames empfangen wurden, wenn ein promisklicher Paketfilter aktiviert wurde. Weitere Informationen zu Paketfiltern finden Sie unter OID_GEN_CURRENT_PACKET_FILTER.
Wenn ein Promiscuous-Paketfilter aktiviert ist, darf der Miniporttreiber diesen Zähler nur für empfangene MPDU-Frames erhöhen, die abgelehnt worden wären, wenn der Filter nicht aktiviert wäre. Der Treiber darf diesen Indikator nicht inkrementieren für:
- Unicast-MPDU-Frames mit einer MAC-Zieladresse, die der MAC-Adresse der 802.11-Station entspricht.
- Multicast- oder Broadcast-MPDU-Frames mit einer MAC-Zieladresse, die mit einem Eintrag in der Multicastadressenliste der 802.11-Station übereinstimmt. Weitere Informationen zur Multicastadressenliste finden Sie unter OID_DOT11_MULTICAST_LIST.
ullFCSErrorCount
Die Anzahl der MPDU-Frames, die die 802.11-Station mit FCS-Fehlern empfangen hat.
Hinweise
Die Member dieser Struktur werden verwendet, um Statistiken auf PHY-Ebene für Folgendes aufzuzeichnen:
- 802.11 MSDU-Pakete.
- 802.11 MMPDU-Frames.
- 802.11 MPDU-Frames. MPDU-Frameindikatoren müssen alle MPDU-Fragmente enthalten, die für ein MSDU-Paket oder einen MMPDU-Frame gesendet werden.
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) |