DOT11_STATISTICS構造 (windot11.h)
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構造体内のすべてのカウンターを無条件にゼロに設定する必要があります。
- ドライバーの MiniportInitializeEx 関数が呼び出されます。
- ドライバーの MiniportOidRequest 関数は、セット要求で指定されたリセット操作の種類に関係なく、 OID_DOT11_RESET_REQUESTの OID セット要求で呼び出されます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
Header | windot11.h (Ndis.h を含む) |