DOT11_EXTSTA_ATTRIBUTES 結構 (windot11.h)

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊,請參閱 WLAN 通用 Windows 驅動程式模型
 
當在 Extensible Station (ExtSTA) 模式中工作時, DOT11_EXTSTA_ATTRIBUTES 結構會定義迷你埠驅動程式和 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 結構。

迷你埠驅動程序必須將 Header 的成員設定為下列值。

類型

此成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT

修訂版

根據驅動程式要執行的作業系統,此成員必須設定為下列其中一個值:

DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Windows Vista

DOT11_EXTSTA_ATTRIBUTES_REVISION_2

Windows Vista 搭配 Service Pack 1 (SP1) 或更新版本的 Windows 操作系統

DOT11_EXTSTA_ATTRIBUTES_REVISION_3

Windows 8 或更新版本的 Windows 作業系統

這些值會決定操作系統如何解譯 bSafeModeImplemented 成員。

大小

此成員必須設定為 sizeof (DOT11_EXTSTA_ATTRIBUTES) 。

如需這些成員的詳細資訊,請參閱 NDIS_OBJECT_HEADER

uScanSSIDListSize

802.11 月臺針對掃描作業支援的服務集標識碼數目上限) (SSID。 802.11 月台必須支援至少四個專案的 SSID 清單。

設定 OID_DOT11_SCAN_REQUEST 時,會指定 802.11 月臺用於掃描的 SSID 清單。

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 月台必須支援至少四個專案的排除 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 月台必須支援至少四個加密密鑰的數據表大小。 針對獨立硬體廠商所開發的加密演算法, (IHV) ,數據表大小可以是四個或更大。

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 () 快取,配對主要密鑰標識碼中的項目數目上限。

如果 802.11 月臺不支援 PMKID 快取,迷你埠驅動程式必須將此成員設定為零。 否則,802.11 月台必須支援至少三個專案的 PMKID 快取大小。

如需 PMKID 快取的詳細資訊,請參閱 OID_DOT11_PMKID_LIST

uMaxNumPerSTADefaultKeyTables

802.11 月臺支援的每個月台預設加密密鑰表數目上限。 建議使用 802.11 月臺支援至少 32 個每個月臺的預設加密密鑰表。

如需每個月台預設加密密鑰表的詳細資訊,請參閱 個別月臺預設密鑰

bStrictlyOrderedServiceClassImplemented

布爾值,如果設定為 TRUE,指定 802.11 月臺支援 IEEE 802.11 StrictlyOrdered 服務類別來進行媒體訪問控制, (MAC) 服務數據單位 (MSDU) 封包傳遞。

如需有關 StrictlyOrdered 服務類別的詳細資訊,請參閱 IEEE 802.11-2012 標準子句 5.1.3。

ucSupportedQoSProtocolFlags

一組旗標,指定 NIC 實作的服務品質 (QoS) 通訊協定。 此成員為下列旗標的零或位 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/迷你埠組合已從美國聯邦資訊) 處理標準 (140-2 發行集 140-2、 密碼編譯模組的安全性需求下,從美國標準 (NIST) 收到驗證憑證。
此成員會與搭配使用 OID_DOT11_SAFE_MODE_ENABLED

uNumSupportedCountryOrRegionStrings

802.11 月臺支援的國家或地區字串數目。 如果 802.11 站支援 IEEE 802.11d-2001 標準所指定的多個法規網域,則每個國家或地區字串都會識別 802.11 站支持的法規網域。

如果 802.11 月臺不支援 IEEE 802.11d-2001 標準,迷你埠驅動程序必須將 uNumSupportedCountryOrRegionStrings 設定為零。

pSupportedCountryOrRegionStrings

802.11 月臺所支援之 802.11 國家/地區字串數位的指標。 數位中的每個項目都會格式化為 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 結構。

uAdhocNumSupportedUcastAlgoPairs

當針對獨立 BSS (IBSS) 網路中的作業設定時,802.11 月台支援傳送和接收單播封包的驗證和加密演算法數目。 uAdhocNumSupportedUcastAlgoPairs 成員必須是 pAdhocSupportedUcastAlgoPairs 成員所參考數位中DOT11_AUTH_CIPHER_PAIR結構的數目。

pAdhocSupportedUcastAlgoPairs

802.11 月臺所支持的驗證和加密演算法數位變數,用於在 IBSS 網路中傳送和接收單播封包。 數位中的每個項目都會格式化為 DOT11_AUTH_CIPHER_PAIR 結構。

uAdhocNumSupportedMcastAlgoPairs

802.11 月台支援的驗證和加密演算法數目,用於在IBSS網路中針對作業進行設定時傳送和接收多播和廣播封包。 uAdhocNumSupportedMcastAlgoPairs 成員必須是 pAdhocSupportedMcastAlgoPairs 成員所參考數位中DOT11_AUTH_CIPHER_PAIR結構的數目。

pAdhocSupportedMcastAlgoPairs

802.11 月台支援的驗證和加密演算法陣列指標,用於在 IBSS 網路中傳送和接收多播和廣播封包。 數位中的每個項目都會格式化為 DOT11_AUTH_CIPHER_PAIR 結構。

bAutoPowerSaveMode

NIC/迷你埠驅動程式組合的支援功能可自發管理電源,包括偵測和交涉適當的 Wi-Fi 電源儲存模式, (PSM) 裝置與 Wi-Fi 存取點之間。 NDIS 6.30 相容 Wi-Fi 迷你埠驅動程序應該將此成員設定為 TRUE。

uMaxNetworkOffloadListSize

如果迷你埠驅動程式能夠支援網路清單卸除功能,可以卸除的網路數目上限。

bMFPCapable

NIC/迷你埠驅動程式的支援功能組合,可支援裝置與 Wi-Fi 存取點之間的管理框架保護,如 802.11w-2009 規格中所指定。 如果支援,請將 設定為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 參數設定為驅動程式配置的記憶體區塊位址,其中包含NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES結構以及DOT11_EXTSTA_ATTRIBUTES結構。

不支援管理畫面格保護 (MFPR) 強制執行 Windows 8。 因此,迷你埠驅動程式在關聯要求期間,不應在RSN IE的RSN功能中設定此位。 針對原則,存取點可能會公告 MFPR,以允許具備 MFP 功能的 STA 建立關聯。 不支援 MFP 功能的存取點將會失敗關聯。 如果 MFPR 是由存取點設定,且 STA 無法啟用 MFP,Windows 8 會將網路視為功能不相符,而不會將關聯要求傳送至迷你埠。

規格需求

需求
最低支援的用戶端 Windows 8 和更新版本的 Windows 作業系統中提供。
標頭 windot11.h (include 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