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 dot11ShortRetryLimit 或 dot11LongRetryLimit MIB 計數器所定義的重試限制之後,無法傳輸的 MSDU 封包和 MMPDU 畫面數。 如需這些 MIB 計數器的詳細資訊,請參閱 OID_DOT11_SHORT_RETRY_LIMIT 或 OID_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) |