DOT11_CIPHER_DEFAULT_KEY_VALUE 구조체(windot11.h)

아티클
02/07/2025

중요하다

WiFiCx Windows 11에서 릴리스된 새로운 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다. WDI 드라이버 모델은 이제 유지 관리 모드에 있으며 높은 우선 순위 수정만 받습니다.

DOT11_CIPHER_DEFAULT_KEY_VALUE 구조체는 802.11 스테이션의 키 테이블에 추가되거나 삭제될 기본 암호 키 또는 스테이션별 기본 암호 키를 정의합니다. 이러한 암호 키 형식에 대한 자세한 내용은 802.11 암호화 키 형식참조하세요.

통사론

typedef struct DOT11_CIPHER_DEFAULT_KEY_VALUE {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uKeyIndex;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_MAC_ADDRESS      MacAddr;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_DEFAULT_KEY_VALUE, *PDOT11_CIPHER_DEFAULT_KEY_VALUE;

회원

Header

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

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

형

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

개정판

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

크기

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

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

uKeyIndex

802.11 스테이션의 기본 키 배열에 있는 키의 인덱스입니다.

표준 802.11 암호화 알고리즘의 경우 uKeyIndex 0에서 3 사이여야 합니다. IHV에서 개발한 암호 알고리즘의 경우 uKeyIndex IHV에서 정의한 범위 내의 모든 값일 수 있습니다.

BIP uKeyIndex 4 또는 5여야 합니다.

IEEE 802.11-2012 표준은 1에서 4까지의 기본 키 인덱스 값을 정의합니다. 이 멤버에서 지정한 x 값은 802.11 기본 키 인덱스(x + 1)에 매핑됩니다.

AlgorithmId

이 키를 사용하는 암호 알고리즘의 값입니다. 암호 알고리즘의 값에 대한 자세한 내용은 DOT11_CIPHER_ALGORITHM참조하세요.

BIP의 경우 초기 IGTK 패킷 번호를 미리 설정하려면 DOT11_CIPHER_ALGO_BIP 설정해야 합니다.

bDelete TRUE 경우 미니포트 드라이버는 이 멤버를 무시해야 합니다.

MacAddr

키를 추가하거나 제거할 기본 키 테이블을 식별하는 MAC(미디어 액세스 제어) 주소입니다.

dot11DesiredBSSType MIB(관리 정보 베이스) 개체가 dot11_BSS_type_infrastructure설정된 경우 802.11 스테이션은 MacAddr 멤버의 값에 관계없이 기본 키 테이블에서 키를 추가하거나 제거합니다. 스테이션이 연결된 액세스 지점(AP)에서 키를 동적으로 가져오는 경우 MacAddr 멤버에는 AP의 MAC 주소가 포함됩니다. 그렇지 않으면 macAddr 값이 0x000000000000.

dot11DesiredBSSType MIB(관리 정보 베이스) 개체가 dot11_BSS_type_independent설정된 경우 802.11 스테이션은 다음과 같은 방법으로 키를 추가하거나 제거해야 합니다.

이 멤버의 값이 0x000000000000 경우 802.11 스테이션은 기본 키 테이블에서 키를 추가하거나 제거합니다. NIC가 ExtAP(Extensible Access Point) OP 모드에 있는 경우 이 값은 0입니다.
이 멤버의 값이 유효한 유니캐스트 MAC 주소인 경우 802.11 스테이션은 MAC 주소가 MacAddr 값과 동일한 독립 BSS(IBSS) 네트워크의 피어 스테이션에 대한 스테이션별 기본 키 테이블에서 키를 추가하거나 제거합니다.

MacAddr값에 대한 스테이션별 기본 키 테이블이 없는 경우 802.11 스테이션은 사용하지 않는 스테이션별 기본 키 테이블을 사용해야 합니다.

dot11DesiredBSSType MIB 개체에 대한 자세한 내용은 OID_DOT11_DESIRED_BSS_TYPE참조하세요.

bDelete

미니포트 드라이버에서 기본 키를 삭제할지 여부를 지정하는 부울 값입니다.

TRUE설정하면 미니포트 드라이버는 uKeyIndex참조하는 기본 키를 삭제해야 합니다. false 설정하면 미니포트 드라이버가 uKeyIndex 참조하는 기본 키를 추가하거나 업데이트해야 합니다.

bStatic

미니포트 드라이버가 연결 또는 로밍 작업 후 기본 키를 삭제할지 여부를 지정하는 부울 값입니다.

FALSE 설정하면 미니포트 드라이버는 802.11 스테이션이 때마다 uKeyIndex에서 참조하는 기본 키를 삭제해야 합니다.

기본 서비스 집합(BSS) 네트워크에서 연결을 끊습니다.
새 BSS 네트워크로 로밍합니다.
동일한 BSS 네트워크에 다시 연결합니다.

true 설정하면 uKeyIndex 참조하는 기본 키는 삭제되지 않아야 합니다.

OID_DOT11_CIPHER_DEFAULT_KEY집합 요청을 통해 명시적으로 삭제되었습니다.
OID_DOT11_RESET_REQUEST메서드 요청을 통해 암시적으로 삭제됩니다.

usKeyLength

ucKey 배열의 키 재질 길이(바이트)입니다.

ucKey[*]

키 자료입니다.

AlgorithmIdDOT11_CIPHER_ALGO_TKIP설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_TKIP_MIC 구조를 통해 키 자료를 정의합니다.

AlgorithmIdDOT11_CIPHER_ALGO_CCMP설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_CCMP 구조를 통해 키 자료를 정의합니다.

AlgorithmIdDOT11_CIPHER_ALGO_BIP설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_BIP 구조를 통해 키 자료를 정의합니다.

ucKey[1]

키 자료입니다.

AlgorithmIdDOT11_CIPHER_ALGO_TKIP설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_TKIP_MIC 구조를 통해 키 자료를 정의합니다.

AlgorithmIdDOT11_CIPHER_ALGO_CCMP설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_CCMP 구조를 통해 키 자료를 정의합니다.

AlgorithmIdDOT11_CIPHER_ALGO_BIP설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_BIP 구조를 통해 키 자료를 정의합니다.

발언

bDelete 멤버가 TRUE 경우 다음 멤버는 유효하지 않으므로 무시해야 합니다.

bStatic
usKeyLength
ucKey

요구 사항

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