共用方式為


DOT11_PHY_FRAME_STATISTICS結構(windot11.h)

重要

WiFiCx 是 Windows 11 中發行的新 Wi-Fi 驅動程式模型。 我們建議您使用WiFiCx來利用最新的功能。 WDI 驅動程式模型現在處於維護模式,而且只會收到高優先順序的修正。

DOT11_PHY_FRAME_STATISTICS結構會記錄 802.11 站 IEEE 實體 (PHY) 層的統計計數器。

語法

typedef struct DOT11_PHY_FRAME_STATISTICS {
  ULONGLONG ullTransmittedFrameCount;
  ULONGLONG ullMulticastTransmittedFrameCount;
  ULONGLONG ullFailedCount;
  ULONGLONG ullRetryCount;
  ULONGLONG ullMultipleRetryCount;
  ULONGLONG ullMaxTXLifetimeExceededCount;
  ULONGLONG ullTransmittedFragmentCount;
  ULONGLONG ullRTSSuccessCount;
  ULONGLONG ullRTSFailureCount;
  ULONGLONG ullACKFailureCount;
  ULONGLONG ullReceivedFrameCount;
  ULONGLONG ullMulticastReceivedFrameCount;
  ULONGLONG ullPromiscuousReceivedFrameCount;
  ULONGLONG ullMaxRXLifetimeExceededCount;
  ULONGLONG ullFrameDuplicateCount;
  ULONGLONG ullReceivedFragmentCount;
  ULONGLONG ullPromiscuousReceivedFragmentCount;
  ULONGLONG ullFCSErrorCount;
} DOT11_PHY_FRAME_STATISTICS, *PDOT11_PHY_FRAME_STATISTICS;

成員

ullTransmittedFrameCount

802.11 月臺 IEEE PHY 層已成功傳輸的 MSDU 封包和 MMPDU 畫面數目。

ullMulticastTransmittedFrameCount

802.11 月臺 IEEE PHY 層已成功傳輸的多播或廣播 MSDU 封包數目和 MMPDU 畫面。

ullFailedCount

802.11 月臺在超過 802.11 IEEE dot11ShortRetryLimitdot11LongRetryLimit MIB 計數器所定義的重試限制之後,無法傳輸的 MSDU 封包和 MMPDU 畫面數。 如需這些 MIB 計數器的詳細資訊,請參閱 OID_DOT11_SHORT_RETRY_LIMITOID_DOT11_LONG_RETRY_LIMIT

ullRetryCount

802.11 月臺在一或多個嘗試之後成功傳輸的 MSDU 封包和 MMPDU 畫面數目。

ullMultipleRetryCount

802.11 月臺在多次重新傳輸嘗試之後成功傳輸的 MSDU 封包和 MMPDU 畫面數目。

針對 MSDU 封包,迷你埠驅動程式必須針對在一或多個 MPDU 片段之後成功傳輸的每個封包遞增此計數器,才需要重新傳輸。

ullMaxTXLifetimeExceededCount

由於 IEEE 802.11 dot11MaxTransmitMSDULifetime MIB 物件所定義的逾時,802.11 月台無法傳輸的 MSDU 封包和 MMPDU 畫面數目。 如需此MIB對象的詳細資訊,請參閱 OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME

ullTransmittedFragmentCount

802.11 月臺通過接收的 802.11 ACK 畫面傳輸並確認的 MPDU 畫面數目。

ullRTSSuccessCount

802.11 月臺收到清除傳送框架的次數,以回應傳送要求 (RTS) 框架。

ullRTSFailureCount

802.11 月臺在回應 RTS 畫面時未收到 CTS 畫面的次數。

ullACKFailureCount

802.11 站預期的次數,沒有收到通知(ACK)框架。

ullReceivedFrameCount

802.11 月臺已成功接收的 MSDU 封包和 MMPDU 畫面總數。

針對 MSDU 封包,迷你埠驅動程式必須針對每個已接收 MPDU 片段的封包遞增此計數器,並傳遞框架檢查順序 (FCS) 驗證和重新執行偵測。 無論收到的 MSDU 封包或 MPDU 片段是否失敗 MAC 層加密解密,迷你埠驅動程式都必須遞增此成員。

此計數器是選擇性的。 如果 NIC 不支援此計數器,迷你埠驅動程式應將此成員設定為 DOT11_STATISTICS_UNKNOWN。

ullMulticastReceivedFrameCount

成功接收 802.11 月臺的多播或廣播 MSDU 封包和 MMPDU 畫面數目。

針對 MSDU 封包,迷你埠驅動程式必須針對收到 MPDU 片段並傳遞 FCS 驗證和重新執行偵測的每個封包遞增此計數器。 無論收到的 MSDU 封包或 MPDU 片段是否失敗 MAC 層加密解密,迷你埠驅動程式都必須遞增此成員。

此計數器是選擇性的。 如果 NIC 不支援此計數器,迷你埠驅動程式應將此成員設定為 DOT11_STATISTICS_UNKNOWN。

ullPromiscuousReceivedFrameCount

啟用混雜封包篩選時,802.11 月臺收到的 MSDU 封包或 MMPDU 畫面數目。 如需封包篩選的詳細資訊,請參閱 OID_GEN_CURRENT_PACKET_FILTER

如果已啟用非交集封包篩選器,迷你埠驅動程式只能針對收到的 MSDU 封包或 MMPDU 畫面遞增此計數器,如果未啟用篩選條件,則此計數器會遭到拒絕。 驅動程式不得針對下列專案遞增此計數器:

  • 具有符合 802.11 月臺 MAC 位址的目的地 MAC 位址的單播 MSDU 封包或 MMPDU 畫面格。
  • 多播或廣播 MSDU 封包或 MMPDU 畫面,其目的地 MAC 位址符合 802.11 月臺多播地址清單中的專案。 如需多播位址清單的詳細資訊,請參閱 OID_DOT11_MULTICAST_LIST

ullMaxRXLifetimeExceededCount

如果 MSDU 封包和 MMPDU 畫面格因為 IEEE 802.11 dot11MaxReceiveLifetime MIB 物件所定義的逾時而捨棄的 MMPDU 框架數目。 如需此MIB對象的詳細資訊,請參閱 OID_DOT11_MAX_RECEIVE_LIFETIME

ullFrameDuplicateCount

802.11 月臺收到的重複 MPDU 畫面數目。 802.11 月臺會透過 802.11 MAC 標頭的 [序列控制] 字段來決定重複的畫面格。

ullReceivedFragmentCount

MSDU 封包或 MMPDU 畫面 802.11 月臺收到的 MPDU 畫面數目。

ullPromiscuousReceivedFragmentCount

啟用混雜封包篩選時,MSDU 封包或 MMPDU 畫面 802.11 月臺收到的 MPDU 畫面數目。 如需封包篩選的詳細資訊,請參閱 OID_GEN_CURRENT_PACKET_FILTER

如果已啟用混雜的封包篩選,迷你埠驅動程式只能針對未啟用篩選條件時拒絕的已接收 MPDU 畫面遞增此計數器。 驅動程式不得針對下列專案遞增此計數器:

  • 具有符合 802.11 月臺 MAC 位址之目的地 MAC 位址的單播 MPDU 畫面格。
  • 多播或廣播 MPDU 畫面與 802.11 月臺多播位址清單中的專案相符的目的地 MAC 位址。 如需多播位址清單的詳細資訊,請參閱 OID_DOT11_MULTICAST_LIST

ullFCSErrorCount

802.11 月臺收到的 MPDU 畫面數目,並出現 FCS 錯誤。

言論

此結構的成員用來記錄下列專案的 PHY 層級統計資料:

  • 802.11 MSDU 封包。
  • 802.11 MMPDU 畫面。
  • 802.11 MPDU 畫面。 MPDU 框架計數器必須包含針對 MSDU 封包或 MMPDU 框架傳送的所有 MPDU 片段

要求

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

另請參閱

可延伸月臺 PHY 統計數據

OID_DOT11_STATISTICS

DOT11_STATISTICS

Native 802.11 統計數據