DOT11_PHY_FRAME_STATISTICS構造体 (windot11.h)
大事な
WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。
DOT11_PHY_FRAME_STATISTICS構造体は、802.11 ステーションの IEEE 物理 (PHY) 層の統計カウンターを記録します。
構文
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;
メンバーズ
ullTransmittedFrameCount
802.11 ステーションの IEEE PHY レイヤーが正常に送信した MSDU パケットと MMPDU フレームの数。
ullMulticastTransmittedFrameCount
802.11 ステーションの IEEE PHY レイヤーが正常に送信されたマルチキャストまたはブロードキャスト MSDU パケットおよび MMPDU フレームの数。
ullFailedCount
802.11 IEEE dot11ShortRetryLimit または dot11LongRetryLimit MIB カウンターによって定義された再試行制限を超えた後に 802.11 ステーションが送信できなかった MSDU パケットと MMPDU フレーム 数。 これらの MIB カウンターの詳細については、OID_DOT11_SHORT_RETRY_LIMIT または OID_DOT11_LONG_RETRY_LIMITを参照してください。
ullRetryCount
802.11 ステーションが 1 回以上試行した後に正常に送信された MSDU パケットと MMPDU フレームの数。
ullMultipleRetryCount
802.11 ステーションが複数の再送信試行の後に正常に送信した MSDU パケットと MMPDU フレームの数。
MSDU パケットの場合、ミニポート ドライバーは、1 つ以上の MPDU フラグメントの再送信が必要になった後に正常に送信されたパケットごとに、このカウンターをインクリメントする必要があります。
ullMaxTXLifetimeExceededCount
IEEE 802.11 dot11MaxTransmitMSDULifetime MIB オブジェクトで定義されているタイムアウトのために、802.11 ステーションが送信できなかった MSDU パケットと MMPDU フレームの数。 この MIB オブジェクトの詳細については、 OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.
ullTransmittedFragmentCount
受信した 802.11 ACK フレームを介して 802.11 ステーションが送信および受信確認した MPDU フレームの数。
ullRTSSuccessCount
802.11 ステーションが送信要求 (RTS) フレームに応答して Clear To Send (CTS) フレームを受信した回数。
ullRTSFailureCount
802.11 ステーションが RTS フレームに応答して CTS フレームを受信しなかった回数。
ullACKFailureCount
802.11 ステーションが受信確認 (ACK) フレームを受け取らなかった回数。
ullReceivedFrameCount
802.11 ステーションが正常に受信した MSDU パケットと MMPDU フレームの合計数。
MSDU パケットの場合、ミニポート ドライバーは、MPDU フラグメントが受信され、フレーム チェック シーケンス (FCS) の検証と再生の検出に合格したパケットごとに、このカウンターをインクリメントする必要があります。 ミニポート ドライバーは、受信した MSDU パケットまたは MPDU フラグメントが MAC 層暗号解読に失敗するかどうかに関係なく、このメンバーをインクリメントする必要があります。
このカウンターは省略可能です。 NIC がこのカウンターをサポートしていない場合、ミニポート ドライバーは、このメンバーをDOT11_STATISTICS_UNKNOWNに設定する必要があります。
ullMulticastReceivedFrameCount
802.11 ステーションが正常に受信したマルチキャストまたはブロードキャスト MSDU パケットと MMPDU フレームの数。
MSDU パケットの場合、ミニポート ドライバーは、MPDU フラグメントを受信し、FCS 検証と再生の検出を渡したパケットごとにこのカウンターをインクリメントする必要があります。 ミニポート ドライバーは、受信した MSDU パケットまたは MPDU フラグメントが MAC 層暗号解読に失敗するかどうかに関係なく、このメンバーをインクリメントする必要があります。
このカウンターは省略可能です。 NIC がこのカウンターをサポートしていない場合、ミニポート ドライバーは、このメンバーをDOT11_STATISTICS_UNKNOWNに設定する必要があります。
ullPromiscuousReceivedFrameCount
無差別パケット フィルタが有効になっているときに 802.11 ステーションによって受信された MSDU パケットまたは MMPDU フレームの数。 パケット フィルタの詳細については、OID_GEN_CURRENT_PACKET_FILTERを参照してください。
無差別パケット フィルターが有効になっている場合、ミニポート ドライバーは、受信した MSDU パケットまたはフィルターが有効になっていない場合に拒否された MMPDU フレームに対してのみ、このカウンターをインクリメントする必要があります。 ドライバーは、次の場合にこのカウンターをインクリメントしないでください。
- 802.11 ステーションの MAC アドレスに一致する宛先 MAC アドレスを持つユニキャスト MSDU パケットまたは MMPDU フレーム。
- 802.11 ステーションのマルチキャスト アドレス リストのエントリに一致する宛先 MAC アドレスを持つマルチキャストまたはブロードキャスト MSDU パケットまたは MMPDU フレーム。 マルチキャスト アドレス一覧の詳細については、OID_DOT11_MULTICAST_LISTを参照してください。
ullMaxRXLifetimeExceededCount
IEEE 802.11 dot11MaxReceiveLifetime MIB オブジェクトで定義されているタイムアウトのために 802.11 ステーションが破棄した MSDU パケットと MMPDU フレームの数。 この MIB オブジェクトの詳細については、 OID_DOT11_MAX_RECEIVE_LIFETIME.
ullFrameDuplicateCount
802.11 ステーションが受信した重複する MPDU フレームの数。 802.11 ステーションは、802.11 MAC ヘッダーのシーケンス制御フィールドを介して重複フレームを決定します。
ullReceivedFragmentCount
MSDU パケットまたは MMPDU フレームに対して 802.11 ステーションが受信した MPDU フレームの数。
ullPromiscuousReceivedFragmentCount
無差別パケット フィルタが有効な場合に MSDU パケットまたは MMPDU フレームに対して 802.11 ステーションが受信した MPDU フレームの数。 パケット フィルタの詳細については、OID_GEN_CURRENT_PACKET_FILTERを参照してください。
無差別パケット フィルターが有効になっている場合、ミニポート ドライバーは、フィルターが有効になっていない場合に拒否された可能性がある受信した MPDU フレームに対してのみ、このカウンターをインクリメントする必要があります。 ドライバーは、次の場合にこのカウンターをインクリメントしないでください。
- 802.11 ステーションの MAC アドレスと一致する宛先 MAC アドレスを持つユニキャスト MPDU フレーム。
- 802.11 ステーションのマルチキャスト アドレス リストのエントリと一致する宛先 MAC アドレスを持つマルチキャストまたはブロードキャスト MPDU フレーム。 マルチキャスト アドレス一覧の詳細については、OID_DOT11_MULTICAST_LISTを参照してください。
ullFCSErrorCount
802.11 ステーションが FCS エラーで受信した MPDU フレームの数。
備考
この構造体のメンバーは、以下の PHY レベルの統計を記録するために使用されます。
- 802.11 MSDU パケット。
- 802.11 MMPDU フレーム。
- 802.11 MPDU フレーム。 MPDU フレーム カウンターには、MSDU パケットまたは MMPDU フレームに送信されるすべての MPDU フラグメントが含まれている必要があります
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | windot11.h (Ndis.h を含む) |