DOT11_STATISTICS構造 (windot11.h)

  • [アーティクル]
大事なネイティブ 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

802.11 ステーションが Wi-Fi 保護アクセス (WPA) または堅牢なセキュリティ ネットワーク 関連付け (RSNA) 認証中に発生した 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 オペレーティング システムで使用できます。
Header windot11.h (Ndis.h を含む)

こちらもご覧ください

OID_DOT11_STATISTICS