DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 구조체(windot11.h)

아티클
08/08/2023

중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WLAN WDI(디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.

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 참조하세요.

참고uStatus 가 0으로 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.

UnicastCipher

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

참고uStatus 가 0으로 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.

MulticastCipher

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

참고uStatus 가 0으로 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.

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 목록의 유일한 항목이어야 합니다.

활성 PHY 목록의 오프셋은 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조를 포함하는 버퍼의 시작을 기준으로 합니다.

참고uStatus 가 0으로 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.

uActivePhyListSize

활성 PHY 목록의 길이(바이트)입니다. uActivePhyListSize 멤버는 의 sizeof(ULONG)배수여야 합니다.

참고uStatus 가 0으로 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.

uBeaconOffset

마지막으로 전송된 802.11 비콘 프레임의 오프셋(바이트)입니다.

Beacon 프레임에는 비콘 프레임 헤더와 모든 정보 요소(ES)가 포함되어 있지만 802.11 MAC 헤더는 포함되지 않습니다. 비콘 프레임 형식은 ISO/IEC 8802-11에 정의되어 있습니다.

비콘 프레임은 데이터 프레임 흐름 제어에 따라 달라지는 실시간 매개 변수 또는 ES 또는 타임스탬프, 라디오 매개 변수, TIM, ERP 및 HT ES와 같은 클라이언트 연결 상태 정확할 필요가 없다는 점을 제외하고 드라이버에서 사용하는 최신 프레임이어야 합니다.

참고uStatus 가 0으로 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.

uBeaconSize

마지막으로 전송된 802.11 비콘 프레임의 길이(바이트)입니다.

참고uStatus 가 0으로 설정되지 않은 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다.

설명

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 포함)