DOT11_PEER_INFO 구조체(windot11.h)

  • 아티클
중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WDI(WLAN 디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.
 
DOT11_PEER_INFO 구조는 IBSS(독립 기본 서비스 세트) 네트워크 내의 피어 스테이션에 대한 정보를 지정합니다.
참고 IBSS(임시) 및 SoftAP는 더 이상 사용되지 않습니다. Windows 8.1 및 Windows Server 2012 R2부터 Wi-Fi Direct 사용합니다.
 

구문

typedef struct _DOT11_PEER_INFO {
  DOT11_MAC_ADDRESS       MacAddress;
  USHORT                  usCapabilityInformation;
  DOT11_AUTH_ALGORITHM    AuthAlgo;
  DOT11_CIPHER_ALGORITHM  UnicastCipherAlgo;
  DOT11_CIPHER_ALGORITHM  MulticastCipherAlgo;
  BOOLEAN                 bWpsEnabled;
  USHORT                  usListenInterval;
  UCHAR                   ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2];
  USHORT                  usAssociationID;
  DOT11_ASSOCIATION_STATE AssociationState;
  DOT11_POWER_MODE        PowerMode;
  LARGE_INTEGER           liAssociationUpTime;
  DOT11_PEER_STATISTICS   Statistics;
} DOT11_PEER_INFO, *PDOT11_PEER_INFO;

멤버

MacAddress

IBSS(독립 BSS) 네트워크 내 피어 스테이션의 MAC(미디어 액세스 제어) 주소입니다.

usCapabilityInformation

802.11 스테이션이 가장 최근에 피어로부터 받은 비콘 또는 프로브 응답 프레임의 802.11 기능 정보 필드입니다.

AuthAlgo

연결 작업 중에 802.11 스테이션이 피어 스테이션으로 확인된 인증 알고리즘입니다. AuthAlgo 멤버의 데이터 형식에 대한 자세한 내용은 DOT11_AUTH_ALGORITHM 참조하세요.

피어가 연결되지 않은 경우 이 멤버는 정의되지 않습니다.

UnicastCipherAlgo

연결 작업 중에 802.11 스테이션이 피어 스테이션으로 확인된 유니캐스트 암호화 알고리즘입니다. UnicastCipherAlgo 멤버의 데이터 형식에 대한 자세한 내용은 DOT11_CIPHER_ALGORITHM.

피어가 연결되지 않은 경우 이 멤버는 정의되지 않습니다.

MulticastCipherAlgo

연결 작업 중에 802.11 스테이션이 피어 스테이션으로 확인된 멀티캐스트 암호화 알고리즘입니다. MulticastCipherAlgo 멤버의 데이터 형식에 대한 자세한 내용은 DOT11_CIPHER_ALGORITHM.

피어가 연결되지 않은 경우 이 멤버는 정의되지 않습니다.

bWpsEnabled

피어 스테이션에 대해 WPS(WiFi Protected Setup)를 사용할 수 있는지 여부를 나타내는 부울 값입니다. TRUE이면 WPS가 사용하도록 설정되고 피어에서 사용하는 인증 및 암호 알고리즘이 AP에서 사용하도록 설정된 알고리즘과 다를 수 있습니다.

피어가 연결되지 않은 경우 이 멤버를 사용하면 안 됩니다.

usListenInterval

연결 요청에서 가져온 802.11 수신 대기 간격 필드를 정의하는 USHORT 값입니다.

피어가 연결되지 않은 경우 이 멤버의 값은 0입니다.

ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2]

피어 스테이션에서 지원하는 데이터 속도를 지정하는 UCHAR 값입니다. 이러한 속도는 802.11 스테이션이 가장 최근에 피어로부터 받은 비콘 또는 프로브 응답 프레임의 802.11 지원 속도 IE를 기반으로 합니다.

ucPeerSupportedRates 배열의 각 항목은 의 쿼리를 통해 반환되는 데이터 속도 테이블 내의 인덱스 값입니다. OID_DOT11_DATA_RATE_MAPPING_TABLE. 인덱스 값은 2에서 127 사이여야 합니다.

피어가 연결되지 않은 경우 이 멤버의 값은 0입니다.

usAssociationID

AP에서 받은 802.11 스테이션의 연결 또는 다시 연결 응답 프레임에서 802.11 연결 ID 필드를 지정하는 USHORT 값입니다.

피어가 연결되지 않은 경우 이 멤버의 값은 0xFFFF.

AssociationState

피어 스테이션의 802.11 인증 및 연결 상태를 나타내는 DOT11_ASSOCIATION_STATE 형식 값입니다. 상태는 dot11_assoc_state_auth_unassoc 또는 dot11_assoc_state_auth_assoc 수 있습니다.

IEEE 802.11 표준에서 802.11 인증 절차는 독립 네트워크에 대한 선택 사항입니다. 따라서 IHV 구현에 따라 dot11_assoc_state_auth_unassoc 열거형 값으로 표시되는 상태는 적용되지 않을 수 있습니다.

PowerMode

피어 스테이션의 최신 전원 관리 모드를 설명하는 DOT11_POWER_MODE 형식 값입니다.

liAssociationUpTime

802.11 연결 프로시저가 성공적으로 완료될 때 타임스탬프를 지정하는 LARGEINTEGER 값입니다. 미니포트 드라이버는 NdisGetCurrentSystemTime 을 호출하여 연결 완료의 타임스탬프를 가져옵니다.

피어가 연결되지 않은 경우 이 멤버의 값은 0입니다.

Statistics

DOT11_PEER_STATISTICS 구조로 정의된 데이터 트래픽에 대한 통계 카운터입니다.

피어가 연결되지 않은 경우 이 멤버의 값은 0입니다.

요구 사항

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

추가 정보

DOT11_POWER_MODE

DOT11_ASSOCIATION_STATE

NdisGetCurrentSystemTime

DOT11_PEER_STATISTICS

DOT11_PEER_INFO_LIST

NDIS_OBJECT_HEADER