DOT11_PHY_FRAME_STATISTICS構造体 (windot11.h)

  • [アーティクル]
大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバー モデル」を参照してください。
 
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 オペレーティング システムで使用できます。
Header windot11.h (Ndis.h を含む)

こちらもご覧ください

拡張可能ステーション PHY 統計

OID_DOT11_STATISTICS

DOT11_STATISTICS

ネイティブ 802.11 統計