DOT11_EXTAP_ATTRIBUTES结构 (windot11.h)

项目
08/08/2023

重要

本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。请改用 WLAN 设备驱动程序接口 (WDI) 。有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

DOT11_EXTAP_ATTRIBUTES结构定义微型端口驱动程序和 802.11 工作站在可扩展接入点 (ExtAP) 模式下运行时的物理和操作属性。

语法

typedef struct _DOT11_EXTAP_ATTRIBUTES {
  NDIS_OBJECT_HEADER              Header;
  ULONG                           uScanSSIDListSize;
  ULONG                           uDesiredSSIDListSize;
  ULONG                           uPrivacyExemptionListSize;
  ULONG                           uAssociationTableSize;
  ULONG                           uDefaultKeyTableSize;
  ULONG                           uWEPKeyValueMaxLength;
  BOOLEAN                         bStrictlyOrderedServiceClassImplemented;
  ULONG                           uNumSupportedCountryOrRegionStrings;
  PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
  ULONG                           uInfraNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedUcastAlgoPairs;
  ULONG                           uInfraNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastAlgoPairs;
} DOT11_EXTAP_ATTRIBUTES, *PDOT11_EXTAP_ATTRIBUTES;

成员

Header

DOT11_EXTAP_ATTRIBUTES结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将 Header 的成员设置为以下值：

类型

此成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。

修订

此成员必须设置为 DOT11_EXTAP_ATTRIBUTES_REVISION_1。

大小

此成员必须设置为 sizeof (DOT11_EXTAP_ATTRIBUTES) 。

有关这些成员的详细信息，请参阅 NDIS_OBJECT_HEADER。

uScanSSIDListSize

802.11 工作站) 扫描操作支持 (SSID 的最大服务集标识符数。 802.11 工作站必须支持至少四个条目的 SSID 列表。

设置 OID_DOT11_SCAN_REQUEST 时，指定 802.11 工作站用于扫描的 SSID 列表。

uDesiredSSIDListSize

802.11 工作站支持的所需基本服务集标识符列表中) (BSSID 的最大条目数。 802.11 工作站必须支持包含至少一个条目的 BSSID 列表。

有关所需 BSSID 列表的详细信息，请参阅 OID_DOT11_DESIRED_BSSID_LIST。

uPrivacyExemptionListSize

802.11 工作站支持的隐私豁免列表中的最大条目数。 802.11 工作站必须支持至少包含一个条目的隐私豁免列表。

有关隐私豁免列表的详细信息，请参阅 OID_DOT11_PRIVACY_EXEMPTION_LIST。

uAssociationTableSize

802.11 工作站可以同时支持的最大关联数。 802.11 工作站必须支持至少包含一个条目的关联列表。一个 NIC 通常应该能够同时支持至少 32 个关联。

如果 NIC 支持任何需要密钥映射密钥的身份验证和密码算法，它必须至少支持其密钥映射密钥表中的条目数。

uDefaultKeyTableSize

802.11 工作站支持的默认密钥表和每站默认密钥表的最大密码密钥数。

对于标准 802.11 密码算法，802.11 工作站必须支持至少四个密码密钥的表大小。对于独立硬件供应商 (IHV) 开发的加密算法，表大小可以为 4 或更大。

uWEPKeyValueMaxLength

802.11 工作站支持的 WEP 密码密钥的最大长度（以字节为单位）。

下表列出了通过 DOT11_CIPHER_ALGORITHM ( 定义的各种 WEP 密码值的最小和最大密钥长度（以字节为单位）。\wlantypes\ne-wlantypes-_dot11_cipher_algorithm.md) 。

WEP 密码	最小密钥长度	最大密钥长度
DOT11_CIPHER_ALGO_WEP40	5	5
DOT11_CIPHER_ALGO_WEP104	13	13
DOT11_CIPHER_ALGO_WEP	13	802.11 工作站支持的任何长度

bStrictlyOrderedServiceClassImplemented

一个布尔值，如果设置为 TRUE，则指定 802.11 工作站支持 IEEE 802.11 StrictlyOrdered 服务类，用于媒体访问控制 (MAC) 服务数据单元 (MSDU) 数据包传送。

有关 StrictlyOrdered 服务类的详细信息，请参阅 IEEE 802.11-2012 标准的第 5.1.3 条。

uNumSupportedCountryOrRegionStrings

802.11 工作站支持的国家或地区字符串数。如果 802.11 工作站支持 IEEE 802.11d-2001 标准指定的多个监管域，则每个国家或地区字符串标识 802.11 工作站支持的监管域。

如果 802.11 工作站不支持 IEEE 802.11d-2001 标准，微型端口驱动程序必须将 uNumSupportedCountryOrRegionStrings 设置为零。

pSupportedCountryOrRegionStrings

指向 802.11 工作站支持的 802.11d 国家或地区字符串数组的指针。数组中的每个条目的格式设置为 DOT11_COUNTRY_OR_REGION_STRING 结构。

uInfraNumSupportedUcastAlgoPairs

802.11 工作站支持的用于发送和接收单播数据包的身份验证和密码算法的数量，该算法在基础结构基本服务集 (BSS) 网络中配置。 uInfraNumSupportedUcastAlgoPairs 成员必须是 pInfraSupportedUcastAlgoPairs 成员引用的数组中的DOT11_AUTH_CIPHER_PAIR结构数。

pInfraSupportedUcastAlgoPairs

指向 802.11 工作站支持的身份验证和密码算法数组的指针，用于在基础结构 BSS 网络中发送和接收单播数据包。数组中的每个条目都格式化为 DOT11_AUTH_CIPHER_PAIR 结构。

uInfraNumSupportedMcastAlgoPairs

802.11 工作站支持的身份验证和密码算法的数量，用于发送和接收多播和广播数据包时，在基础结构基本服务集 (BSS) 网络。 uInfraNumSupportedMcastAlgoPairs 成员必须是 pInfraSupportedMcastAlgoPairs 成员引用的数组中的DOT11_AUTH_CIPHER_PAIR结构数。

pInfraSupportedMcastAlgoPairs

指向 802.11 工作站支持的身份验证和密码算法数组的指针，用于在基础结构 BSS 网络中发送和接收多播和广播数据包。数组中的每个条目都格式化为 DOT11_AUTH_CIPHER_PAIR 结构。