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 結構。
迷你埠驅動程序必須將 Header 的成員設定為下列值：
類型
這個成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。
修訂版
這個成員必須設定為 DOT11_STATISTICS_REVISION_1。
大小
這個成員必須設定為 sizeof(DOT11_STATISTICS)。
如需這些成員的詳細資訊，請參閱 NDIS_OBJECT_HEADER。
ullFourWayHandshakeFailures
802.11 月臺在 Wi-Fi Protected Access (WPA) 或強固安全性網路關聯 (RSNA) 驗證期間遇到的四向交握失敗數目。
如果 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 標頭中目的地 MAC 位址符合 802.11 月臺 MAC 位址的封包遞增。
MacMcastCounters
MAC 層計數器是以 802.11 月臺所傳送或接收的多播或廣播封包為基礎。 這個成員的數據結構是 DOT11_MAC_FRAME_STATISTICS 結構。
接收多播或廣播封包的計數器，只能針對 802.11 MAC 標頭中目的地 MAC 位址符合 802.11 月臺之多播地址清單中的專案之封包遞增。 如需多播通訊清單的詳細資訊，請參閱 OID_DOT11_MULTICAST_LIST。
PhyCounters[1]
PHY 層計數器的陣列。 此陣列中的每個項目都會格式化為 DOT11_PHY_FRAME_STATISTICS 結構。
迷你埠驅動程式必須針對每個支援的 PHY 維護 PhyCounters 陣列內的專案。 如果 802.11 月台支援相同類型的多個 PHY，迷你埠驅動程式必須為每個月臺建立個別的專案。
PhyCounters 陣列中的專案順序必須與驅動程式在查詢時所傳回的支援 PHY 清單相同 OID_DOT11_SUPPORTED_PHY_TYPES。
備註
當發生下列其中一項時，迷你埠驅動程序必須無條件地將DOT11_STATISTICS結構中的所有計數器設定為零，包括 MAC 層和 PHY 層計數器：
- 會呼叫驅動程式的 MiniportInitializeEx函 式。
- 不論集合要求中指定的重設作業類型為何，驅動程式 的MiniportOidRequest 函式都會使用 OID_DOT11_RESET_REQUEST的 OID 集合要求來呼叫。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 標頭 | windot11.h (包含 Ndis.h) |