Share via


DOT11_PHY_FRAME_STATISTICS 구조체(windot11.h)

중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WDI(WLAN 디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.
 
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 IEEE dot11ShortRetryLimit 또는 dot11LongRetryLimit MIB 카운터에 정의된 재시도 제한을 초과한 후 802.11 스테이션이 전송하지 못한 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 ACK 프레임을 통해 802.11 스테이션이 전송하고 승인한 MPDU 프레임의 수입니다.

ullRTSSuccessCount

802.11 스테이션이 RTS(송신 요청) 프레임에 대한 응답으로 CTS(Clear To Send) 프레임을 받은 횟수입니다.

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 프레임입니다.
  • 802.11 스테이션의 멀티캐스트 주소 목록에 있는 항목과 일치하는 대상 MAC 주소가 있는 멀티캐스트 또는 브로드캐스트 MSDU 패킷 또는 MMPDU 프레임 멀티캐스트 주소 목록에 대한 자세한 내용은 OID_DOT11_MULTICAST_LIST.

ullMaxRXLifetimeExceededCount

IEEE 802.11 dot11MaxReceiveLifetime MIB 개체에 정의된 시간 제한으로 인해 802.11 스테이션이 삭제된 MSDU 패킷 및 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 프레임입니다.
  • 802.11 스테이션의 멀티캐스트 주소 목록에 있는 항목과 일치하는 대상 MAC 주소가 있는 멀티캐스트 또는 브로드캐스트 MPDU 프레임입니다. 멀티캐스트 주소 목록에 대한 자세한 내용은 OID_DOT11_MULTICAST_LIST.

ullFCSErrorCount

FCS 오류로 802.11 스테이션에서 받은 MPDU 프레임 수입니다.

설명

이 구조체의 멤버는 다음의 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

네이티브 802.11 통계