DOT11_STATISTICS 구조체(windot11.h)

  • 아티클
중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WDI(WLAN 디바이스 드라이버 인터페이스)를 사용하세요. 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 구조체로 형식이 지정됩니다.

미니포트 드라이버는 헤더 의 멤버를 다음 값으로 설정해야 합니다.

형식

이 멤버는 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다.

수정 버전

이 멤버는 DOT11_STATISTICS_REVISION_1 설정해야 합니다.

크기

이 멤버는 로 sizeof(DOT11_STATISTICS)설정해야 합니다.

이러한 멤버에 대한 자세한 내용은 NDIS_OBJECT_HEADER.

ullFourWayHandshakeFailures

WPA(보호된 액세스) 또는 RSNA(강력한 보안 네트워크 연결) 인증 Wi-Fi 중에 802.11 스테이션에서 발생한 4방향 핸드셰이크 오류 수입니다.

802.11 스테이션이 WPA 또는 RSNA 인증을 수행하지 않는 경우 이 멤버를 DOT11_STATISTICS_UNKNOWN 설정해야 합니다.

ullTKIPCounterMeasuresInvoked

802.11 스테이션이 MIC(메시지 무결성 코드) 실패 후 대책을 호출한 횟수입니다.

802.11 스테이션이 TKIP 대책을 수행하지 않는 경우 이 멤버를 DOT11_STATISTICS_UNKNOWN 설정해야 합니다.

ullReserved

이 멤버는 운영 체제에서 사용하도록 예약되어 있습니다. 미니포트 드라이버는 이 멤버에게 쓰지 않아야 합니다.

MacUcastCounters

MAC 계층 카운터는 802.11 스테이션에서 보내거나 받은 유니캐스트 패킷을 기반으로 합니다. 이 멤버의 데이터 구조는 DOT11_MAC_FRAME_STATISTICS 구조체입니다.

참고  

수신된 유니캐스트 패킷에 대한 카운터는 802.11 스테이션의 MAC 주소와 일치하는 802.11 MAC 헤더에 대상 MAC 주소가 있는 패킷에 대해서만 증가해야 합니다.

MacMcastCounters

MAC 계층 카운터는 802.11 스테이션에서 보내거나 받은 멀티캐스트 또는 브로드캐스트 패킷을 기반으로 합니다. 이 멤버의 데이터 구조는 DOT11_MAC_FRAME_STATISTICS 구조체입니다.

참고  

수신된 멀티캐스트 또는 브로드캐스트 패킷에 대한 카운터는 802.11 스테이션의 멀티캐스트 주소 목록의 항목과 일치하는 802.11 MAC 헤더에 대상 MAC 주소가 있는 패킷에 대해서만 증가해야 합니다. 멀티캐스트 주소 목록에 대한 자세한 내용은 OID_DOT11_MULTICAST_LIST.

PhyCounters[1]

PHY 계층 카운터의 배열입니다. 이 배열의 각 항목은 로 형식이 지정됩니다. DOT11_PHY_FRAME_STATISTICS 구조체입니다.

미니포트 드라이버는 지원되는 각 PHY에 대해 PhyCounters 배열 내에서 항목을 유지해야 합니다. 802.11 스테이션이 동일한 유형의 여러 PHY를 지원하는 경우 미니포트 드라이버는 각각에 대해 별도의 항목을 만들어야 합니다.

PhyCounters 배열 내의 항목은 드라이버가 쿼리할 때 반환하는 지원되는 PHY 목록과 동일한 순서여야 합니다. OID_DOT11_SUPPORTED_PHY_TYPES.

설명

미니포트 드라이버는 다음 중 하나가 발생할 때 MAC 계층 및 PHY 계층 카운터를 포함하여 DOT11_STATISTICS 구조의 모든 카운터를 무조건 0으로 설정해야 합니다.

Native 802.11 미니포트 드라이버에서 수집한 통계에 대한 자세한 내용은 네이티브 802.11 통계를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글 windot11.h(Ndis.h 포함)

추가 정보

OID_DOT11_STATISTICS