DOT11_EXTSTA_ATTRIBUTES 구조체(windot11.h)
구문
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)에서 유효성 검사 인증서를 받았습니다.
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 포함) |