DOT11_AUTH_CIPHER_PAIR_LIST 구조체(windot11.h)

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

 

DOT11_AUTH_CIPHER_PAIR_LIST 구조체는 DOT11_AUTH_CIPHER_PAIR 구조의 목록을 정의합니다.

구문

typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;

멤버

Header

DOT11_AUTH_CIPHER_PAIR_LIST 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.

미니포트 드라이버는 헤더 의 멤버를 다음 값으로 설정해야 합니다.

형식

이 멤버는 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다.

수정 버전

이 멤버는 DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1 설정해야 합니다.

크기

이 멤버는 로 sizeof(DOT11_AUTH_CIPHER_PAIR_LIST)설정해야 합니다.

이러한 멤버에 대한 자세한 내용은 NDIS_OBJECT_HEADER 참조하세요.

uNumOfEntries

AuthCipherPairs 배열의 항목 수입니다.

uTotalNumOfEntries

AuthCipherPairs 배열에 포함될 수 있는 최대 항목 수입니다.

AuthCipherPairs[1]

의 목록 DOT11_AUTH_CIPHER_PAIR 구조체.

설명

미니포트 드라이버는 둘 중 하나에서 쿼리할 때 DOT11_AUTH_CIPHER_PAIR_LIST 구조를 반환합니다. OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR 또는 OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

이러한 OID를 쿼리할 때 미니포트 드라이버는 MiniportOidRequest 함수의 OidRequest 매개 변수의 InformationBuffer 멤버가 AuthCipherPairs 배열의 모든 항목을 포함하여 전체 DOT11_AUTH_CIPHER_PAIR_LIST 구조를 반환할 수 있을 만큼 큰지 확인해야 합니다. OidRequest 매개 변수의 InformationBufferLength 멤버 값은 다음 목록에서 보여 주듯이 미니포트 드라이버가 수행해야 하는 작업을 결정합니다.

• InformationBufferLength 멤버의 값이 전체 DOT11_AUTH_CIPHER_PAIR_LIST 구조체의 길이(바이트)보다 작은 경우 미니포트 드라이버는 다음을 수행해야 합니다.
  • OidRequest 매개 변수의 경우 BytesWritten 멤버를 0으로 설정하고 BytesNeeded 멤버를 전체 DOT11_AUTH_CIPHER_PAIR_LIST 구조체의 길이(바이트)로 설정합니다.
  • MiniportOidRequest 함수에서 NDIS_STATUS_BUFFER_OVERFLOW 반환하여 쿼리 요청에 실패합니다.
• InformationBufferLength 멤버의 값이 전체 DOT11_AUTH_CIPHER_PAIR_LIST 구조체의 길이(바이트)보다 크거나 같은 경우 미니포트 드라이버는 다음을 수행하여 성공적인 쿼리 요청을 완료해야 합니다.
  • DOT11_AUTH_CIPHER_PAIR_LIST 구조체의 경우 uNumOfEntries 및 uTotalNumOfEntries 멤버를 AuthCipherPairs 배열의 총 항목 수로 설정합니다.
  • OidRequest 매개 변수의 경우 BytesNeeded 멤버를 0으로 설정하고 BytesWritten 멤버를 전체 DOT11_AUTH_CIPHER_PAIR_LIST 구조체의 길이(바이트)로 설정합니다. 또한 미니포트 드라이버는 전체 DOT11_AUTH_CIPHER_PAIR_LIST 구조를 InformationBuffer 멤버에 복사해야 합니다.
  • MiniportOidRequest 함수에서 NDIS_STATUS_SUCCESS 반환합니다.

Windows 7부터 802.11 미니포트 드라이버는 지원되는 인증 및 암호 알고리즘 쌍의 조합을 DOT11_AUTH_CIPHER_PAIR_LIST 보고할 수 있습니다. 그러나 운영 체제가 소프트 AP를 시작하는 경우 DOT11_AUTH_ALGO_RSNA_PSK 인증 알고리즘과 DOT11_CIPHER_ALGO_CCMP 암호화 알고리즘만 사용하도록 설정합니다. 소프트 AP를 지원하려면 미니포트 드라이버가 이 인증/암호 쌍을 지원해야 합니다.

확장 가능한 AP 모드에서 작동하는 NIC에서 WPS를 사용하는 경우 미니포트 드라이버는 사용 권한 부여 및 암호 알고리즘에 관계없이 개방형 시스템 인증 또는 WEP(유선 등가 개인 정보 보호) 알고리즘을 사용하여 피어 스테이션이 확장 가능한 AP와 연결되도록 허용해야 합니다. WPS 및 확장 가능한 AP에 대한 자세한 내용은 OID_DOT11_WPS_ENABLED 참조하세요.

요구 사항

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

추가 정보

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER