次の方法で共有

DOT11_STATISTICS構造体 (windot11.h)

  • [アーティクル]
重要Native 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨です。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、WLAN ユニバーサル Windows ドライバー モデル を参照してください。

DOT11_STATISTICS構造体は、802.11 インターフェイスの統計カウンターを記録します。

構文

typedef struct DOT11_STATISTICS {
  NDIS_OBJECT_HEADER         Header;
  ULONGLONG                  ullFourWayHandshakeFailures;
  ULONGLONG                  ullTKIPCounterMeasuresInvoked;
  ULONGLONG                  ullReserved;
  DOT11_MAC_FRAME_STATISTICS MacUcastCounters;
  DOT11_MAC_FRAME_STATISTICS MacMcastCounters;
  DOT11_PHY_FRAME_STATISTICS PhyCounters[1];
} DOT11_STATISTICS, *PDOT11_STATISTICS;

メンバーズ

Header

DOT11_STATISTICS構造体の型、リビジョン、およびサイズ。 このメンバーは、NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポート ドライバーは、ヘッダー のメンバーを次の値に設定する必要があります。

種類

このメンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。

改定

このメンバーは、DOT11_STATISTICS_REVISION_1に設定する必要があります。

大きさ

このメンバーは、sizeof(DOT11_STATISTICS)に設定する必要があります。

これらのメンバーの詳細については、NDIS_OBJECT_HEADERを参照してください。

ullFourWayHandshakeFailures

保護されたアクセス (WPA) または堅牢なセキュリティ ネットワーク アソシエーション (RSNA) 認証中 Wi-Fi に 802.11 ステーションで発生した 4 方向ハンドシェイクエラーの数。

802.11 ステーションが WPA または RSNA 認証を実行していない場合は、このメンバーを DOT11_STATISTICS_UNKNOWN に設定する必要があります。

ullTKIPCounterMeasuresInvoked

802.11 ステーションが、メッセージ整合性コード (MIC) エラーの後に対策を呼び出した回数。

802.11 ステーションが TKIP 対策を実行していない場合は、このメンバーを DOT11_STATISTICS_UNKNOWN に設定する必要があります。

ullReserved

このメンバーは、オペレーティング システムで使用するために予約されています。 ミニポート ドライバーは、このメンバーに書き込む必要があります。

MacUcastCounters

802.11 ステーションによって送受信されるユニキャスト パケットに基づく MAC レイヤー カウンター。 このメンバーのデータ構造は次のとおりです。 DOT11_MAC_FRAME_STATISTICS 構造体。

ノート  

受信ユニキャスト パケットのカウンターは、802.11 ステーションの MAC アドレスと一致する 802.11 MAC ヘッダーの宛先 MAC アドレスを持つパケットに対してのみインクリメントする必要があります。

MacMcastCounters

802.11 ステーションによって送受信されるマルチキャストまたはブロードキャスト パケットに基づく MAC レイヤー カウンター。 このメンバーのデータ構造は次のとおりです。 DOT11_MAC_FRAME_STATISTICS 構造体。

ノート  

受信したマルチキャストまたはブロードキャスト パケットのカウンターは、802.11 ステーションのマルチキャスト アドレス リストのエントリと一致する 802.11 MAC ヘッダーの宛先 MAC アドレスを持つパケットに対してのみインクリメントする必要があります。 マルチキャスト アドレス一覧の詳細については、OID_DOT11_MULTICAST_LISTを参照してください。

PhyCounters[1]

PHY レイヤー カウンターの配列。 この配列内の各エントリは、次のように書式設定されます。 DOT11_PHY_FRAME_STATISTICS 構造体。

ミニポート ドライバーは、サポートされている各 PHY の PhyCounters 配列内のエントリを維持する必要があります。 802.11 ステーションが同じ種類の複数の PHY をサポートしている場合、ミニポート ドライバーは、それぞれに個別のエントリを作成する必要があります。

PhyCounters 配列内のエントリは、ドライバーがクエリを実行したときに返されるサポートされている PHY の一覧と同じ順序にする必要があります OID_DOT11_SUPPORTED_PHY_TYPES.

備考

ミニポート ドライバーは、次のいずれかの場合、MAC 層と PHY 層カウンターを含む、DOT11_STATISTICS構造体内のすべてのカウンターを無条件にゼロに設定する必要があります。

ネイティブ 802.11 ミニポート ドライバーによって収集される統計情報の詳細については、「ネイティブ 802.11 統計 を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
ヘッダー windot11.h (Ndis.h を含む)

関連項目

OID_DOT11_STATISTICS