DOT11_STATISTICS 구조체(windot11.h)
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으로 설정해야 합니다.
- 드라이버의 MiniportInitializeEx 함수가 호출됩니다.
- 드라이버의 MiniportOidRequest 함수는 집합 요청에 지정된 재설정 작업의 유형에 관계없이 OID_DOT11_RESET_REQUEST OID 집합 요청으로 호출됩니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
머리글 | windot11.h(Ndis.h 포함) |