DOT11_EXTSTA_ATTRIBUTES 구조체(windot11.h)

중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WLAN WDI(디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.
 
DOT11_EXTSTA_ATTRIBUTES 구조체는 ExtSTA(확장 가능 스테이션) 모드에서 작동할 때 미니포트 드라이버 및 802.11 스테이션의 물리적 및 작동 특성을 정의합니다. 이 작업 모드에 대한 자세한 내용은 확장 가능한 스테이션 작업 모드를 참조하세요.

구문

typedef struct DOT11_EXTSTA_ATTRIBUTES {
  NDIS_OBJECT_HEADER              Header;
  ULONG                           uScanSSIDListSize;
  ULONG                           uDesiredBSSIDListSize;
  ULONG                           uDesiredSSIDListSize;
  ULONG                           uExcludedMacAddressListSize;
  ULONG                           uPrivacyExemptionListSize;
  ULONG                           uKeyMappingTableSize;
  ULONG                           uDefaultKeyTableSize;
  ULONG                           uWEPKeyValueMaxLength;
  ULONG                           uPMKIDCacheSize;
  ULONG                           uMaxNumPerSTADefaultKeyTables;
  BOOLEAN                         bStrictlyOrderedServiceClassImplemented;
  UCHAR                           ucSupportedQoSProtocolFlags;
  BOOLEAN                         bSafeModeImplemented;
  ULONG                           uNumSupportedCountryOrRegionStrings;
  PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
  ULONG                           uInfraNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedUcastAlgoPairs;
  ULONG                           uInfraNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastAlgoPairs;
  ULONG                           uAdhocNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedUcastAlgoPairs;
  ULONG                           uAdhocNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedMcastAlgoPairs;
  BOOLEAN                         bAutoPowerSaveMode;
  ULONG                           uMaxNetworkOffloadListSize;
  BOOLEAN                         bMFPCapable;
  ULONG                           uInfraNumSupportedMcastMgmtAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastMgmtAlgoPairs;
} DOT11_EXTSTA_ATTRIBUTES, *PDOT11_EXTSTA_ATTRIBUTES;

멤버

Header

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

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

형식

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

수정 버전

이 멤버는 드라이버가 실행되도록 의도된 운영 체제에 따라 다음 값 중 하나로 설정해야 합니다.

DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Windows Vista

DOT11_EXTSTA_ATTRIBUTES_REVISION_2

Windows Vista SP1(서비스 팩 1) 이상 버전의 Windows 운영 체제

DOT11_EXTSTA_ATTRIBUTES_REVISION_3

Windows 운영 체제의 Windows 8 이상 버전

이러한 값은 운영 체제가 bSafeModeImplemented 멤버를 해석하는 방법을 결정합니다.

크기

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

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

uScanSSIDListSize

검사 작업을 위해 802.11 스테이션에서 지원하는 최대 SSID(서비스 집합 식별자) 수입니다. 802.11 스테이션은 최소 4개 항목의 SSID 목록을 지원해야 합니다.

802.11 스테이션이 검사에 사용하는 SSID 목록은 OID_DOT11_SCAN_REQUEST 설정될 때 지정됩니다.

uDesiredBSSIDListSize

802.11 스테이션에서 지원하는 기본 서비스 집합 식별자(BSSID)의 원하는 목록에 있는 최대 항목 수입니다. 802.11 스테이션은 하나 이상의 항목이 있는 BSSID 목록을 지원해야 합니다.

원하는 BSSID 목록에 대한 자세한 내용은 OID_DOT11_DESIRED_BSSID_LIST.

uDesiredSSIDListSize

802.11 스테이션에서 지원하는 원하는 SSID 목록의 최대 항목 수입니다. 802.11 스테이션은 하나 이상의 항목으로 원하는 SSID 목록을 지원해야 합니다.

원하는 SSID 목록에 대한 자세한 내용은 OID_DOT11_DESIRED_SSID_LIST.

uExcludedMacAddressListSize

802.11 스테이션에서 지원하는 제외된 MAC 주소 목록의 최대 항목 수입니다. 802.11 스테이션은 4개 이상의 항목이 있는 제외된 MAC 주소 목록을 지원해야 합니다.

원하는 제외된 MAC 주소 목록에 대한 자세한 내용은 OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST.

uPrivacyExemptionListSize

802.11 스테이션에서 지원하는 개인 정보 면제 목록의 최대 항목 수입니다. 802.11 스테이션은 하나 이상의 항목으로 개인 정보 면제 목록을 지원해야 합니다.

개인 정보 면제 목록에 대한 자세한 내용은 OID_DOT11_PRIVACY_EXEMPTION_LIST.

uKeyMappingTableSize

802.11 스테이션에서 지원하는 최대 암호 키 매핑 키 수입니다. 802.11 스테이션은 32개 이상의 키 매핑 키를 지원하는 것이 좋습니다.

키 매핑 키에 대한 자세한 내용은 OID_DOT11_CIPHER_KEY_MAPPING_KEY.

uDefaultKeyTableSize

802.11 스테이션에서 기본 키 및 스테이션별 기본 키 테이블에 대해 지원하는 최대 암호 키 수입니다.

표준 802.11 암호화 알고리즘의 경우 802.11 스테이션은 최소 4개의 암호 키의 테이블 크기를 지원해야 합니다. IHV(독립 하드웨어 공급업체)에서 개발한 암호 알고리즘의 경우 테이블 크기는 4개 이상일 수 있습니다.

uWEPKeyValueMaxLength

802.11 스테이션에서 지원하는 WEP 암호 키의 최대 길이(바이트)입니다.

다음 표에서는 DOT11_CIPHER_ALGORITHM 통해 정의된 다양한 WEP 암호화 값에 대한 최소 및 최대 키 길이(바이트 )를 나열합니다.

WEP 암호 최소 키 길이 최대 키 길이
DOT11_CIPHER_ALGO_WEP40 5 5
DOT11_CIPHER_ALGO_WEP104 13 13
DOT11_CIPHER_ALGO_WEP 13 802.11 스테이션에서 지원하는 모든 길이

uPMKIDCacheSize

802.11 스테이션에서 지원하는 PMKID(키 식별자) 캐시와 쌍으로 master 최대 항목 수입니다.

802.11 스테이션이 PMKID 캐시를 지원하지 않는 경우 미니포트 드라이버는 이 멤버를 0으로 설정해야 합니다. 그렇지 않으면 802.11 스테이션은 3개 이상의 항목의 PMKID 캐시 크기를 지원해야 합니다.

PMKID 캐시에 대한 자세한 내용은 OID_DOT11_PMKID_LIST 참조하세요.

uMaxNumPerSTADefaultKeyTables

802.11 스테이션에서 지원하는 스테이션당 기본 암호 키 테이블의 최대 수입니다. 802.11 스테이션은 스테이션당 최소 32개 이상의 기본 암호 키 테이블을 지원하는 것이 좋습니다.

스테이션별 기본 암호 키 테이블에 대한 자세한 내용은 스테이션별 기본 키를 참조하세요.

bStrictlyOrderedServiceClassImplemented

TRUE로 설정된 경우 802.11 스테이션이 MAC(미디어 액세스 제어) MSDU(서비스 데이터 단위) 패킷 배달을 위한 IEEE 802.11 StrictlyOrdered 서비스 클래스를 지원하도록 지정하는 부울 값입니다.

StrictlyOrdered 서비스 클래스에 대한 자세한 내용은 IEEE 802.11-2012 표준의 절 5.1.3을 참조하세요.

ucSupportedQoSProtocolFlags

NIC가 구현하는 QoS(서비스 품질) 프로토콜을 지정하는 플래그 집합입니다. 이 멤버는 다음 플래그의 0 또는 비트 OR 조합입니다.

DOT11_QOS_PROTOCOL_FLAG_WMM

NIC는 802.11 WMM QoS 프로토콜을 구현합니다.

DOT11_QOS_PROTOCOL_FLAG_11E

NIC는 802.11e QoS 프로토콜을 구현합니다.

bSafeModeImplemented

NIC/미니포트 드라이버 조합의 안전 모드 지원 기능입니다. 운영 체제는 Header.Revision 값에 따라 이 멤버를 다르게 해석합니다.

Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_1

운영 체제는 bSafeModeImplemented 멤버를 부울 값으로 해석합니다. 이 값이 TRUE이면 NIC는 802.11 안전 작업 모드를 구현합니다. 그렇지 않으면 값이 FALSE입니다.

수정 버전 = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 이상

운영 체제는 bSafeModeImplemented 멤버를 다음과 같은 가능한 비트 값이 설정된 비트 필드로 해석합니다.

  • 비트 필드가 다른 비트가 설정되지 않은 DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED 설정된 경우 미니포트 드라이버는 802.11 안전 작업 모드를 구현합니다.
  • 비트 필드가 DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED 설정된 경우 NIC/미니포트 조합은 FIPS(Federal Information Processing Standards) Publication 140-2, 암호화 모듈에 대한 보안 요구 사항에 따라 NIST(National Institute of Standards and Technology)에서 유효성 검사 인증서를 받았습니다.
이 멤버는 와 함께 사용됩니다. OID_DOT11_SAFE_MODE_ENABLED.

uNumSupportedCountryOrRegionStrings

802.11 스테이션에서 지원하는 국가 또는 지역 문자열의 수입니다. 802.11 스테이션이 IEEE 802.11d-2001 표준에 지정된 대로 여러 규제 도메인을 지원하는 경우 각 국가 또는 지역 문자열은 802.11 스테이션에서 지원하는 규제 도메인을 식별합니다.

802.11 스테이션이 IEEE 802.11d-2001 표준을 지원하지 않는 경우 미니포트 드라이버는 uNumSupportedCountryOrRegionStrings를 0으로 설정해야 합니다.

pSupportedCountryOrRegionStrings

802.11 스테이션에서 지원하는 802.11d 국가 또는 지역 문자열 배열에 대한 포인터입니다. 배열의 각 항목은 로 형식이 지정됩니다. DOT11_COUNTRY_OR_REGION_STRING 구조체입니다.

uInfraNumSupportedUcastAlgoPairs

BSS(인프라 기본 서비스 집합) 네트워크에서 작동하도록 구성된 경우 유니캐스트 패킷을 보내고 받기 위해 802.11 스테이션에서 지원하는 인증 및 암호 알고리즘의 수입니다. uInfraNumSupportedUcastAlgoPairs 멤버는 pInfraSupportedUcastAlgoPairs 멤버가 참조하는 배열의 DOT11_AUTH_CIPHER_PAIR 구조체 수여야 합니다.

pInfraSupportedUcastAlgoPairs

인프라 BSS 네트워크에서 유니캐스트 패킷을 보내고 받기 위해 802.11 스테이션에서 지원하는 인증 및 암호 알고리즘 배열에 대한 포인터입니다. 배열의 각 항목은 로 형식이 지정됩니다. DOT11_AUTH_CIPHER_PAIR 구조체입니다.

uInfraNumSupportedMcastAlgoPairs

BSS(인프라 기본 서비스 집합) 네트워크에서 작동하도록 구성된 경우 멀티캐스트 및 브로드캐스트 패킷을 보내고 받기 위해 802.11 스테이션에서 지원하는 인증 및 암호 알고리즘의 수입니다. uInfraNumSupportedMcastAlgoPairs 멤버는 pInfraSupportedMcastAlgoPairs 멤버가 참조하는 배열의 DOT11_AUTH_CIPHER_PAIR 구조체 수여야 합니다.

pInfraSupportedMcastAlgoPairs

인프라 BSS 네트워크에서 멀티캐스트 및 브로드캐스트 패킷을 보내고 받기 위해 802.11 스테이션에서 지원하는 인증 및 암호 알고리즘 배열에 대한 포인터입니다. 배열의 각 항목은 로 형식이 지정됩니다. DOT11_AUTH_CIPHER_PAIR 구조체입니다.

uAdhocNumSupportedUcastAlgoPairs

독립 BSS(BSS) 네트워크에서 작동하도록 구성된 경우 유니캐스트 패킷을 보내고 받기 위해 802.11 스테이션에서 지원하는 인증 및 암호 알고리즘의 수입니다. uAdhocNumSupportedUcastAlgoPairs 멤버는 pAdhocSupportedUcastAlgoPairs 멤버가 참조하는 배열의 DOT11_AUTH_CIPHER_PAIR 구조체 수여야 합니다.

pAdhocSupportedUcastAlgoPairs

IBSS 네트워크에서 유니캐스트 패킷을 보내고 받기 위해 802.11 스테이션에서 지원하는 인증 및 암호화 알고리즘 배열에 대한 포인터입니다. 배열의 각 항목은 로 형식이 지정됩니다. DOT11_AUTH_CIPHER_PAIR 구조체입니다.

uAdhocNumSupportedMcastAlgoPairs

IBSS 네트워크에서 작동하도록 구성된 경우 멀티캐스트 및 브로드캐스트 패킷을 보내고 받기 위해 802.11 스테이션에서 지원하는 인증 및 암호 알고리즘의 수입니다. uAdhocNumSupportedMcastAlgoPairs 멤버는 pAdhocSupportedMcastAlgoPairs 멤버가 참조하는 배열의 DOT11_AUTH_CIPHER_PAIR 구조체 수여야 합니다.

pAdhocSupportedMcastAlgoPairs

IBSS 네트워크에서 멀티캐스트 및 브로드캐스트 패킷을 보내고 받기 위해 802.11 스테이션에서 지원하는 인증 및 암호 알고리즘 배열에 대한 포인터입니다. 배열의 각 항목은 로 형식이 지정됩니다. DOT11_AUTH_CIPHER_PAIR 구조체입니다.

bAutoPowerSaveMode

디바이스와 Wi-Fi 액세스 지점 간의 적절한 Wi-Fi PSM(절전 모드)의 검색 및 협상을 포함하여 전원을 자율적으로 관리하는 NIC/미니포트 드라이버 조합의 지원 기능입니다. NDIS 6.30 규격 Wi-Fi 미니포트 드라이버는 이 멤버를 TRUE로 설정해야 합니다.

uMaxNetworkOffloadListSize

네트워크 목록 오프로드 기능을 지원하는 기능이 있는 경우 미니포트 드라이버가 오프로드할 수 있는 최대 네트워크 수입니다.

bMFPCapable

802.11w-2009 사양에 지정된 대로 디바이스와 Wi-Fi 액세스 지점 간의 관리 프레임 보호를 지원하기 위해 조합하는 NIC/미니포트 드라이버의 지원 기능입니다. 지원되는 경우 TRUE로 설정합니다. 그렇지 않으면 이 멤버를 FALSE로 설정해야 합니다.

uInfraNumSupportedMcastMgmtAlgoPairs

pInfraSupportedMcastMgmtAlgoPairs에서 가리키는 인증 및 암호 알고리즘 쌍 배열의 길이입니다.

pInfraSupportedMcastMgmtAlgoPairs

디바이스가 인프라 모드에서 MFP를 지원하는 인증 및 암호화 알고리즘 쌍 배열에 대한 포인터입니다. Windows 8 권장되는 암호는 WPA 또는 WPA2 인증을 사용하는 BIP입니다. 배열의 각 항목은 로 형식이 지정됩니다. DOT11_AUTH_CIPHER_PAIR 구조체입니다.

bNeighborReportSupported

bAPChannelReportSupported

bActionFramesSupported

bANQPQueryOffloadSupported

bHESSIDConnectionSupported

설명

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 구조체에는 DOT11_EXTSTA_ATTRIBUTES 구조체의 주소를 지정하는 멤버(pExtSTAAttributes)가 포함되어 있습니다. 미니포트 드라이버가 NdisMSetMiniportAttributes를 호출하면 드라이버는 MiniportAttributes 매개 변수를 DOT11_EXTSTA_ATTRIBUTES 구조와 함께 NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 구조가 포함된 드라이버 할당 메모리 블록의 주소로 설정합니다.

Windows 8 MFPR(관리 프레임 보호 필요) 적용은 지원되지 않습니다. 따라서 미니포트 드라이버는 연결 요청 중에 RSN IE의 RSN 기능에서 이 비트를 설정해서는 안 됩니다. 정책의 경우 액세스 지점은 MFP 지원 STA를 연결할 수 있는 MFPR을 보급할 수 있습니다. MFP 기능을 지원하지 않는 액세스 지점은 연결에 실패합니다. MFPR이 액세스 포인트에 의해 설정되고 STA가 MFP를 사용할 수 없는 경우 Windows 8 네트워크를 기능과 일치하지 않는 것으로 처리하고 미니포트에 연결 요청을 보내지 않습니다.

요구 사항

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

추가 정보

확장 가능한 스테이션 작업 모드

OID_DOT11_DESIRED_BSSID_LIST

OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

OID_DOT11_PMKID_LIST

OID_DOT11_DESIRED_SSID_LIST

DOT11_COUNTRY_OR_REGION_STRING

OID_DOT11_SAFE_MODE_ENABLED

OID_DOT11_PRIVACY_EXEMPTION_LIST

NDIS_OBJECT_HEADER

OID_DOT11_CIPHER_KEY_MAPPING_KEY

DOT11_AUTH_CIPHER_PAIR

DOT11_CIPHER_ALGORITHM

스테이션별 기본 키

NdisMSetMiniportAttributes

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

OID_DOT11_SCAN_REQUEST