共用方式為

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 結構。

迷你埠驅動程序必須將 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 層計數器：

如需 Native 802.11 迷你埠驅動程式所收集之統計數據的詳細資訊，請參閱 Native 802.11 Statistics。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
標頭 windot11.h (包含 Ndis.h)

另請參閱

OID_DOT11_STATISTICS