DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 구조체(windot11.h)
DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 구조체는 인프라 BSS의 피어 스테이션에서 연결 요청을 받은 후 802.11 스테이션에서 수행하는 연결 작업의 결과를 지정합니다.
구문
typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS PeerMacAddr;
ULONG uStatus;
UCHAR ucErrorSource;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;
멤버
Header
DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.
미니포트 드라이버는 헤더 의 멤버를 다음 값으로 설정해야 합니다.
형식
이 멤버는 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다.
수정 버전
이 멤버는 DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1 설정해야 합니다.
크기
이 멤버는 sizeof(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS)로 설정해야 합니다.
이러한 멤버에 대한 자세한 내용은 NDIS_OBJECT_HEADER 참조하세요.
PeerMacAddr
연결 요청을 보낸 피어 스테이션의 MAC(미디어 액세스 제어) 주소입니다.
uStatus
피어 스테이션과의 연결 상태. 0이면 연결이 성공합니다. 0이 아닌 경우 연결이 실패합니다.
ucErrorSource
uStatus의 0이 아닌 값의 경우 이 멤버는 연결을 방지하는 오류의 원인을 나타냅니다. NIC는 ucErrorSource 를 다음 값 중 하나로 설정해야 합니다.
DOT11_ASSOC_ERROR_SOURCE_OS
미니포트 드라이버는 메모리 부족 오류와 같은 시스템 오류로 인해 연결 절차를 거부했습니다. 이 경우 uStatus 는 운영 체제에서 반환된 NDIS_STATUS_XXX 또는 NTSTATUS_XXX 코드로 설정해야 합니다.
DOT11_ASSOC_ERROR_SOURCE_REMOTE
AP 또는 피어 스테이션이 연결 절차를 거부했습니다. 이 경우 uStatus를 802.11로 설정해야 상태 코드는 802.11 인증 프레임, 연결 응답 프레임 또는 다시 연결 응답 프레임을 형성합니다. IEEE 802.11-2003 사양의 표 19에는 가능한 모든 값이 포함되어 있습니다. 미니포트 드라이버는 수정될 때 이 IEEE 사양에서 새 값을 반환할 수도 있습니다.
DOT11_ASSOC_ERROR_SOURCE_OTHER
IHV 관련 이유로 연결이 실패했습니다. 이 경우 uStatus 에는 IHV에서 지정한 0이 아닌 값이 포함됩니다.
bReAssocReq
피어 스테이션의 요청이 다시 연결 요청인지 여부를 나타내는 부울 값입니다.
bReAssocResp
NIC의 응답이 다시 연결 요청인지 여부를 나타내는 부울 값입니다.
uAssocReqOffset
연결 작업에 사용되는 요청 프레임의 오프셋입니다. 프레임에는 정보 요소(ES)가 포함되지만 802.11 MAC 헤더는 포함되지 않습니다.
uAssocReqSize
연결 작업에 사용되는 요청 프레임의 길이(바이트)입니다. 프레임에는 정보 요소(ES)가 포함되지만 802.11 MAC 헤더는 포함되지 않습니다.
uAssocRespOffset
연결 작업에 사용되는 응답 프레임의 오프셋입니다. 프레임에는 정보 요소(ES)가 포함되지만 802.11 MAC 헤더는 포함되지 않습니다.
uAssocRespSize
연결 작업에 사용되는 응답 프레임의 길이(바이트)입니다. 프레임에는 정보 요소(ES)가 포함되지만 802.11 MAC 헤더는 포함되지 않습니다.
AuthAlgo
연결 작업 중에 802.11 스테이션이 피어 스테이션으로 확인된 인증 알고리즘입니다. AuthAlgo 멤버의 데이터 형식에 대한 자세한 내용은 DOT11_AUTH_ALGORITHM 참조하세요.
UnicastCipher
802.11 스테이션이 연결 작업 중에 피어 스테이션으로 확인된 유니캐스트 암호화 알고리즘입니다. UnicastCipher 멤버의 데이터 형식에 대한 자세한 내용은 DOT11_CIPHER_ALGORITHM.
MulticastCipher
802.11 스테이션이 연결 작업 중에 AP 또는 피어 스테이션으로 확인된 멀티캐스트 암호 알고리즘입니다. MulticastCipher 멤버의 데이터 형식에 대한 자세한 내용은 DOT11_CIPHER_ALGORITHM.
uActivePhyListOffset
802.11 스테이션이 BSS 네트워크 연결에서 패킷을 보내거나 받는 데 사용하는 PHY 식별자(ID) 목록의 오프셋입니다. 각 항목은 ULONG 값입니다.
ExtSTA(Extensible Station) msDot11ActivePhyList MIB objec도 활성 PHY 목록을 참조합니다.
활성 PHY 목록의 항목은 다음 값 중 하나일 수 있습니다.
- ExtSTA(Extensible Station) msDot11DesiredPhyList 관리 정보 베이스(MIB) 개체에 의해 지정된 PHY ID입니다. 이 MIB 개체에 대한 자세한 내용은 OID_DOT11_DESIRED_PHY_LIST 참조하세요.
-
DOT11_PHY_ID_ANY PHY ID입니다. ExtSTA msDot11ActivePhyList MIB 개체가 msDot11DesiredPhyList MIB 개체로 지정된 모든 PHY ID를 지정하는 경우 미니포트 드라이버는 이 값으로 항목을 설정할 수 있습니다. 이 MIB 개체에 대한 자세한 내용은 OID_DOT11_ACTIVE_PHY_LIST 참조하세요.
참고 값이 DOT11_PHY_ID_ANY 항목은 활성 PHY 목록의 유일한 항목이어야 합니다.
uActivePhyListSize
활성 PHY 목록의 길이(바이트)입니다. uActivePhyListSize 멤버는 의 sizeof(ULONG)배수여야 합니다.
uBeaconOffset
마지막으로 전송된 802.11 비콘 프레임의 오프셋(바이트)입니다.
Beacon 프레임에는 비콘 프레임 헤더와 모든 정보 요소(ES)가 포함되어 있지만 802.11 MAC 헤더는 포함되지 않습니다. 비콘 프레임 형식은 ISO/IEC 8802-11에 정의되어 있습니다.
비콘 프레임은 데이터 프레임 흐름 제어에 따라 달라지는 실시간 매개 변수 또는 ES 또는 타임스탬프, 라디오 매개 변수, TIM, ERP 및 HT ES와 같은 클라이언트 연결 상태 정확할 필요가 없다는 점을 제외하고 드라이버에서 사용하는 최신 프레임이어야 합니다.
uBeaconSize
마지막으로 전송된 802.11 비콘 프레임의 길이(바이트)입니다.
Beacon 프레임에는 비콘 프레임 헤더와 모든 정보 요소(ES)가 포함되어 있지만 802.11 MAC 헤더는 포함되지 않습니다. 비콘 프레임 형식은 ISO/IEC 8802-11에 정의되어 있습니다.
비콘 프레임은 데이터 프레임 흐름 제어에 따라 달라지는 실시간 매개 변수 또는 ES 또는 타임스탬프, 라디오 매개 변수, TIM, ERP 및 HT ES와 같은 클라이언트 연결 상태 정확할 필요가 없다는 점을 제외하고 드라이버에서 사용하는 최신 프레임이어야 합니다.
설명
Native 802.11 미니포트 드라이버에는 드라이버가 를 만들 때 DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 구조가 포함됩니다. 상태 표시를 NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION.
NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION 상태 표시는 연결 표시 블록의 끝을 표시합니다. 연결이 성공하면 NIC는 원래 연결을 요청한 스테이션에 해당 연결 응답 프레임을 성공적으로 보낸 후 NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION 표시해야 합니다. 연결이 실패하면 NIC는 응답이 성공적으로 전송되었는지 여부를 NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION 표시해야 합니다. 실패는 NIC 또는 운영 체제가 연결 요청을 거부하거나 802.11 프레임워크와 관련이 없는 오류 때문일 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 운영 체제의 Windows 7 이상 버전에서 사용할 수 있습니다. |
| 머리글 | windot11.h(Ndis.h 포함) |