DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조체(windot11.h)
중요
Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WDI(WLAN 디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.
DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조체는 AP(액세스 지점) 또는 피어 스테이션을 사용하여 802.11 스테이션에서 수행하는 연결 작업의 결과를 지정합니다. Native 802.11 미니포트 드라이버는 미니포트 드라이버가 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 상태 표시할 때 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조를 포함합니다.
구문
typedef struct DOT11_ASSOCIATION_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS MacAddr;
DOT11_ASSOC_STATUS uStatus;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
ULONG uIHVDataOffset;
ULONG uIHVDataSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
BOOLEAN bFourAddressSupported;
BOOLEAN bPortAuthorized;
UCHAR ucActiveQoSProtocol;
DOT11_DS_INFO DSInfo;
ULONG uEncapTableOffset;
ULONG uEncapTableSize;
DOT11_CIPHER_ALGORITHM MulticastMgmtCipher;
ULONG uAssocComebackTime;
} DOT11_ASSOCIATION_COMPLETION_PARAMETERS, *PDOT11_ASSOCIATION_COMPLETION_PARAMETERS;
멤버
Header
DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.
미니포트 드라이버는 헤더 의 멤버를 다음 값으로 설정해야 합니다.
형식
이 멤버는 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다.
수정 버전
이 멤버는 DOT11_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1 설정해야 합니다.
크기
이 멤버는 로 sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS)설정해야 합니다.
이러한 멤버에 대한 자세한 내용은 NDIS_OBJECT_HEADER.
MacAddr
802.11 스테이션이 연결하려고 시도한 액세스 지점(AP) 또는 피어 스테이션(독립 BSS(IBSS) 네트워크의 경우)의 MAC(미디어 액세스 제어) 주소입니다.
uStatus
DOT11_ASSOC_STATUS 정의된 값으로 지정된 연결 작업의 완료 상태.
bReAssocReq
802.11 스테이션이 AP에 802.11 연결 또는 재연결 프레임을 보냈는지 여부를 나타내는 부울 값입니다. TRUE인 경우 802.11 스테이션은 AP에 801.11 재연결 요청 프레임을 보냈습니다. FALSE인 경우 802.11 스테이션은 AP에 802.11 연결 요청 프레임을 보냈습니다.
bReAssocReq 멤버에 대한 TRUE 값은 dot11DesiredBSSType MIB 개체가 dot11_BSS_type_infrastructure 설정된 경우에만 유효합니다.
bReAssocResp
802.11 스테이션이 AP로부터 802.11 연결 또는 재연결 프레임을 받았는지 여부를 나타내는 부울 값입니다. TRUE인 경우 802.11 스테이션은 AP로부터 802.11 재연결 응답 프레임을 받았습니다. FALSE인 경우 802.11 스테이션은 AP로부터 802.11 연결 응답 프레임을 받았습니다.
bReAssocResp 멤버의 TRUE 값은 dot11DesiredBSSType MIB 개체가 dot11_BSS_type_infrastructure 설정된 경우에만 유효합니다.
uAssocReqOffset
연결 작업에 사용되는 요청 프레임의 오프셋입니다. 프레임에는 802.11 MAC 헤더가 포함되지 않습니다.
이 오프셋은 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조를 포함하는 버퍼의 시작을 기준으로 합니다.
미니포트 드라이버에서 반환되는 연결 요청 프레임은 IEEE 802.11 dot11DesiredBSSType MIB 개체의 설정에 따라 달라집니다.
- dot11DesiredBSSType MIB 개체가 dot11_BSS_type_infrastructure 설정된 경우 프레임은 AP에 전송된 802.11 연결 요청 프레임(bReAssocReq가 FALSE인 경우) 또는 다시 연결 요청 프레임(bReAssocReq가 TRUE인 경우)입니다. 미니포트 드라이버는 연결 개시자가 보내거나 연결 작업 중에 교환된 정보를 기반으로 드라이버에서 만든 802.11 프로브 요청 프레임을 반환해야 합니다.
- dot11DesiredBSSType MIB 개체가 dot11_BSS_type_independent 설정된 경우 미니포트 드라이버는 uAssocReqOffset 멤버를 0으로 설정해야 합니다.
미니포트 드라이버는 연결 작업 중에 요청 프레임을 보낼 수 없는 경우 uAssocReqOffset 및 uAssocReqSize 멤버를 0으로 설정해야 합니다. 예를 들어 AP가 802.11 스테이션에서 보낸 802.11 인증 프레임에 실패한 경우 미니포트 드라이버는 uAssocReqOffset 및 uAssocReqSize 를 0으로 설정해야 합니다.
uAssocReqSize
연결 작업에 사용되는 요청 프레임의 길이입니다. 프레임의 길이에는 802.11 MAC 헤더가 포함되지 않습니다.
dot11DesiredBSSType MIB 개체가 dot11_BSS_type_independent 설정된 경우 미니포트 드라이버는 uAssocReqSize 멤버를 0으로 설정해야 합니다.
uAssocRespOffset
연결 작업에 사용되는 응답 프레임의 오프셋입니다. 프레임에는 802.11 MAC 헤더가 포함되지 않습니다.
이 오프셋은 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조를 포함하는 버퍼의 시작을 기준으로 합니다.
미니포트 드라이버에서 반환되는 연결 응답 프레임은 IEEE 802.11 dot11DesiredBSSType MIB 개체의 설정에 따라 달라집니다.
dot11DesiredBSSType MIB 개체가 dot11_BSS_type_infrastructure 설정된 경우 프레임은 AP에서 받은 802.11 연결 응답 프레임(bReAssocReq가 TRUE인 경우) 또는 재연결 응답 프레임(bReAssocReq가 FALSE인 경우)입니다. 미니포트 드라이버는 연결 시작자에 전송되거나 연결 작업 중에 교환된 정보를 기반으로 드라이버에서 만든 802.11 프로브 응답 프레임을 반환해야 합니다.
dot11DesiredBSSType MIB 개체가 dot11_BSS_type_independent 설정된 경우 미니포트 드라이버는 uAssocRespOffset 멤버를 0으로 설정해야 합니다.
미니포트 드라이버는 연결 작업 중에 응답 프레임을 받지 못한 경우 uAssocRespOffset 및 uAssocRespSize 멤버를 0으로 설정해야 합니다.
uAssocRespSize
연결 작업에 사용되는 응답 프레임의 길이입니다. 프레임의 길이에는 802.11 MAC 헤더가 포함되지 않습니다.
dot11DesiredBSSType MIB 개체가 dot11_BSS_type_independent 설정된 경우 미니포트 드라이버는 uAssocRespSize 멤버를 0으로 설정해야 합니다.
uBeaconOffset
마지막으로 받은 802.11 비콘 또는 프로브 응답 프레임의 오프셋입니다. 미니포트 드라이버는 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 상태 표시할 때 이러한 프레임에 대해 802.11 MAC 헤더를 제외해야 합니다.
이 오프셋은 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조를 포함하는 버퍼의 시작을 기준으로 합니다.
참고
연결에 사용된 인증 알고리즘이 Wi-Fi 보호된 액세스(WPA) 또는 IEEE 802.11i RSNA(강력한 보안 네트워크 연결)인 경우 미니포트 드라이버는 항상 마지막으로 수신한 802.11 비콘 프레임을 반환해야 하며 uBeaconOffset 및 uBeaconSize 멤버를 0으로 설정해서는 안 됩니다.
uBeaconSize
마지막으로 받은 802.11 비콘 프레임의 길이입니다. 프레임의 길이에는 802.11 MAC 헤더가 포함되지 않습니다.
uIHVDataOffset
IHV에서 정의한 독점 형식의 데이터 블록 오프셋입니다. IHV는 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 상태 표시와 관련된 모든 용도로 이 데이터 블록을 사용할 수 있습니다.
이 오프셋은 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조를 포함하는 버퍼의 시작을 기준으로 합니다.
미니포트 드라이버가 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 상태 표시에서 IHV 데이터를 반환하지 않는 경우 uIHVDataOffset을 0으로 설정해야 합니다.
uIHVDataSize
IHV에서 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 상태 표시에 사용하는 데이터 블록의 길이입니다. 미니포트 드라이버가 이 표시에서 IHV 데이터를 반환하지 않는 경우 uIHVDataSize 를 0으로 설정해야 합니다.
AuthAlgo
연결 작업 중에 802.11 스테이션이 AP 또는 피어 스테이션으로 확인된 인증 알고리즘입니다. AuthAlgo 멤버의 데이터 형식에 대한 자세한 내용은 DOT11_AUTH_ALGORITHM 참조하세요.
uStatus가 DOT11_ASSOCIATION_STATUS_SUCCESS 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.
UnicastCipher
연결 작업 중에 802.11 스테이션이 AP 또는 피어 스테이션으로 확인된 유니캐스트 암호화 알고리즘입니다. UnicastCipher 멤버의 데이터 형식에 대한 자세한 내용은 DOT11_CIPHER_ALGORITHM.
uStatus가 DOT11_ASSOCIATION_STATUS_SUCCESS 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.
MulticastCipher
연결 작업 중에 802.11 스테이션이 AP 또는 피어 스테이션으로 확인된 멀티캐스트 암호화 알고리즘입니다. MulticastCipher 멤버의 데이터 형식에 대한 자세한 내용은 DOT11_CIPHER_ALGORITHM
uStatus가 DOT11_ASSOCIATION_STATUS_SUCCESS 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.
uActivePhyListOffset
802.11 스테이션이 BSS 네트워크 연결에서 패킷을 보내거나 받는 데 사용하는 PHY 식별자(ID) 목록의 오프셋입니다.
ExtSTA(Extensible Station) msDot11ActivePhyList MIB 개체도 활성 PHY 목록을 참조합니다.
이 MIB 개체에 대한 자세한 내용은 OID_DOT11_ACTIVE_PHY_LIST.
활성 PHY 목록의 항목은 다음 값 중 하나일 수 있습니다.
- ExtSTA msDot11DesiredPhyList MIB 개체에 의해 지정된 PHY ID입니다. 이 MIB 개체에 대한 자세한 내용은 OID_DOT11_DESIRED_PHY_LIST 참조하세요.
- DOT11_PHY_ID_ANY. msDot11ActivePhyList MIB 개체가 msDot11DesiredPhyList MIB 개체에 의해 지정된 모든 PHY ID를 지정하는 경우 미니포트 드라이버는 이 값으로 항목을 설정할 수 있습니다. 값이 DOT11_PHY_ID_ANY 항목은 활성 PHY 목록의 유일한 항목이어야 합니다.
활성 PHY 목록의 오프셋은 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조를 포함하는 버퍼의 시작을 기준으로 합니다.
uStatus가 DOT11_ASSOCIATION_STATUS_SUCCESS 설정되지 않은 경우 미니포트 드라이버는 uActivePhyListOffset 및 uActivePhyListSize 멤버를 0으로 설정해야 합니다.
uActivePhyListSize
활성 PHY 목록의 길이입니다. uActivePhyListSize 멤버는 의 sizeof(ULONG)배수여야 합니다.
bFourAddressSupported
TRUE로 설정된 경우 802.11 스테이션이 모바일 스테이션 및 AP를 포함하여 BSS 네트워크의 모든 스테이션에서 ISO 계층 2 브리징에 대한 배포 시스템(DS) 서비스를 지원하는 AP와 연결되었음을 지정하는 부울 값입니다. 이 지원의 결정은 IHV의 구현과 관련이 있습니다.
다음 중 true인 경우 미니포트 드라이버는 bFourAddressSupported 멤버를 FALSE 로 설정해야 합니다.
- IEEE 802.11 dot11DesiredBSSType MIB 개체는 dot11_BSS_type_independent 설정됩니다.
- 802.11 스테이션은 DS 서비스를 지원하는 AP와 연결되지 않았거나 AP가 DS 서비스를 지원하는지 여부를 확인할 수 없습니다.
- uStatus 멤버가 DOT11_ASSOCIATION_STATUS_SUCCESS 설정되지 않았습니다.
bPortAuthorized
TRUE로 설정된 경우 802.11 스테이션이 연결 작업 중에 포트 권한 부여를 성공적으로 수행했음을 지정하는 부울 값입니다. 포트 권한 부여는 IEEE 802.1X/802.11i 표준 또는 IHV에서 개발한 독점 알고리즘을 기반으로 할 수 있습니다.
다음 중 true인 경우 미니포트 드라이버는 bPortAuthorized 를 FALSE 로 설정해야 합니다.
- 802.11 스테이션은 포트 권한 부여를 수행하지 않습니다.
- uStatus 멤버가 DOT11_ASSOCIATION_STATUS_SUCCESS 설정되지 않았습니다.
포트 권한 부여에 대한 자세한 내용은 포트 기반 네트워크 액세스를 참조하세요.
ucActiveQoSProtocol
이 연결에 대해 현재 활성 상태인 QoS(서비스 품질) 프로토콜을 지정하는 플래그입니다. 이 멤버는 0이거나(QoS 프로토콜이 활성 상태가 없음을 나타낸) 또는 다음 플래그 중 하나입니다.
DOT11_QOS_PROTOCOL_FLAG_WMM
NIC는 802.11 WMM QoS 프로토콜을 사용하고 있습니다.
DOT11_QOS_PROTOCOL_FLAG_11E
NIC는 802.11e QoS 프로토콜을 사용하고 있습니다.
DSInfo
802.11 스테이션이 이전 연결 작업과 동일한 DS에 연결되어 있는지 여부를 지정하는 DOT11_DS_INFO 값입니다.
DSInfo 멤버의 형식은 다음 값을 지정하는 DOT11_DS_INFO 열거형으로 지정됩니다.
DOT11_DS_CHANGED
802.11 스테이션은 연결 작업 후 새 DS에 연결되었습니다.
DOT11_DS_UNCHANGED
802.11 스테이션은 연결 작업에서 동일한 DS에 연결됩니다.
DOT11_DS_UNKNOWN
미니포트 드라이버는 연결 작업 후에 DS가 변경되었는지 여부를 확인할 수 없습니다.
참고
dot11DesiredBSSType MIB 개체가 dot11_BSS_type_independent 설정된 경우 미니포트 드라이버는 DSInfo를 DOT11_DS_UNKNOWN 설정해야 합니다.
uEncapTableOffset
BSS 연결에 대한 IEEE EtherType 캡슐화 목록의 오프셋입니다.
이 오프셋은 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조를 포함하는 버퍼의 시작을 기준으로 합니다. uEncapTableOffset 값은 4 바이트 경계에 맞춰야 합니다.
미니포트 드라이버는 이 목록의 각 항목의 형식을 DOT11_ENCAP_ENTRY 구조로 지정합니다.
EtherType 캡슐화 목록에 대한 자세한 내용은 802.11 페이로드 캡슐화를 참조하세요.
uEncapTableSize
EtherType 캡슐화 목록의 길이입니다.
MulticastMgmtCipher
NIC가 MFP(관리 프레임 보호) 연결을 위해 선택(협상)하는 멀티캐스트 암호화 알고리즘입니다. MFP가 협상되면 이 멤버는 DOT11_CIPHER_ALGO_BIP 합니다. MFP가 협상되지 않은 경우 이 필드는 DOT11_CIPHER_ALGO_NONE 합니다.
uAssocComebackTime
(re)연결이 802.11 이유 코드 30("연결 요청이 일시적으로 거부됨, 나중에 다시 시도하세요.")과 함께 실패하면 이 멤버는 액세스 지점(AP)에서 요청한 연결 복귀 시간의 값을 나타냅니다. 802.11 연결 해제 이유 코드는 연결 요청에 응답할 때 가장 낮은 16비 트 uStatus 에 있습니다.
Windows의 자동 연결 서비스는 AP를 차단된 목록에 추가하고 적어도 표시된 복귀 시간 동안 다시 연결하려고 시도하지 않습니다. NIC는 다음 연결 시퀀스가 시작될 때까지 일반 실패한 인증처럼 작동합니다. 지정된 시간 제한(복귀)이 경과하고 연결 프로세스가 중지된 후 Windows는 더 나은 대체 연결을 찾거나 이 연결로 복귀할 수 있습니다. 이 멤버에 설정된 이 값은 802.11 사양에 정의된 시간 단위를 사용해야 합니다. 예를 들어 TU입니다.
설명
다음 중 어느 것이라도 true인 경우 미니포트 드라이버는 uEncapTableOffset 및 uEncapTableSize 멤버를 0으로 설정해야 합니다.
- BSS 연결에는 운영 체제의 EtherType 캡슐화 기본 목록을 변경할 필요가 없습니다.
- uStatus 멤버가 DOT11_ASSOCIATION_STATUS_SUCCESS 설정되지 않았습니다.
- ExtSTA(Extensible Station) dot11DesiredBSSType MIB(관리 정보 기반) 개체는 dot11_BSS_type_independent 설정됩니다.
IEEE 802.11 dot11DesiredBSSType MIB 개체에 대한 자세한 내용은 OID_DOT11_DESIRED_BSS_TYPE 참조하세요.
연결 작업에 대한 자세한 내용은 연결 작업을 참조하세요.
AP(액세스 지점)와 STA가 (re) 연결 프로시저(즉, )를 진행하는 동안 해당 RSN ES에서 MFPC(Management Frame Protection Capable) 필드를 1로 설정하면 관리 프레임 보호가 협상됩니다. AP에 대한 비콘 또는 프로브 응답 및 (RE)STA에 대한 연결 요청) 및 양 당사자는 4방향 핸드셰이크(802.11i 4방향 핸드셰이크 중 메시지 M2 및 M3)에서 관리 프레임 보호 가능 비트가 1로 설정된 것을 확인합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 운영 체제의 Windows 8 이상 버전에서 사용할 수 있습니다. |
| 머리글 | windot11.h(Ndis.h 포함) |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기