DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構（windot11.h）
重要
WiFiCx 是 Windows 11 中發行的新 Wi-Fi 驅動程式模型。 我們建議您使用WiFiCx來利用最新的功能。 WDI 驅動程式模型現在處於維護模式，而且只會收到高優先順序的修正。
DOT11_ASSOCIATION_COMPLETION_PARAMETERS 結構會指定 802.11 月臺與存取點 （AP） 或對等站所執行之關聯作業的結果。 當迷你埠驅動程序發出 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 狀態指示時，Native 802.11 迷你埠驅動程式包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構。
語法
typedef struct DOT11_ASSOCIATION_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS MacAddr;
DOT11_ASSOC_STATUS uStatus;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
ULONG uIHVDataOffset;
ULONG uIHVDataSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
BOOLEAN bFourAddressSupported;
BOOLEAN bPortAuthorized;
UCHAR ucActiveQoSProtocol;
DOT11_DS_INFO DSInfo;
ULONG uEncapTableOffset;
ULONG uEncapTableSize;
DOT11_CIPHER_ALGORITHM MulticastMgmtCipher;
ULONG uAssocComebackTime;
} DOT11_ASSOCIATION_COMPLETION_PARAMETERS, *PDOT11_ASSOCIATION_COMPLETION_PARAMETERS;
成員
Header
DOT11_ASSOCIATION_COMPLETION_PARAMETERS 結構的型別、修訂和大小。 此成員的格式為 NDIS_OBJECT_HEADER 結構。
迷你埠驅動程序必須將 Header 的成員設定為下列值：
類型
這個成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。
校訂
這個成員必須設定為 DOT11_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1。
大小
這個成員必須設定為 sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS)。
如需這些成員的詳細資訊，請參閱 NDIS_OBJECT_HEADER。
MacAddr
802.11 月台嘗試連線到的存取點 （AP） 或對等站 （適用於獨立 BSS （IBSS） 網路的媒體存取控制 （MAC） 位址。
uStatus
關聯作業的完成狀態，如針對 DOT11_ASSOC_STATUS定義的值所指定。
bReAssocReq
布爾值，指出802.11月臺是否會傳送802.11關聯或重新關聯框架給AP。 如果 TRUE，則 802.11 月臺會將 801.11 重新關聯要求框架傳送給 AP。 如果 FALSE，則 802.11 月臺會將 802.11 關聯要求框架傳送給美聯社。
bReAssocReq 成員 TRUE 值只有在 miB 物件設定為 dot11_BSS_type_infrastructure時， dot11DesiredBSSType 的值才有效。
bReAssocResp
布爾值，指出 802.11 月臺是否從 AP 收到 802.11 關聯或重新關聯框架。 如果 TRUE,802.11 月臺會從 AP 收到 802.11 重新關聯回應框架。 如果 FALSE，則 802.11 月臺收到來自 AP 的 802.11 關聯回應框架。
只有當miB物件設定為 dot11_BSS_type_infrastructure時，bReAssocResp 成員的 true true 值才有效。
uAssocReqOffset
關聯作業中使用的要求框架位移。 框架不包含 802.11 MAC 標頭。
這個位移相對於包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構的緩衝區開頭。
迷你埠驅動程式傳回的關聯要求框架取決於 IEEE 802.11 dot11DesiredBSSType MIB 物件的設定：
- 如果 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_infrastructure， 框架是 802.11 關聯要求框架（如果 bReAssocReq 是 FALSE）， 或重新關聯要求框架 （如果 bReAssocReq 是 TRUE），則傳送至 AP。迷你埠驅動程式必須傳回由關聯啟動器傳送的 802.11 探查要求框架，或由驅動程式根據關聯作業期間交換的資訊所建立。
- 如果 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_independent，迷你埠驅動程序必須將 uAssocReqOffset 成員設定為零。
迷你埠驅動程式必須在關聯作業期間無法傳送要求框架時，將 uAssocReqOffset，並將 uAssocReqSize 成員設定為零。 例如，如果 AP 失敗了 802.11 月臺所傳送的 802.11 驗證框架，迷你埠驅動程式必須將 uAssocReqOffset，並將 uAssocReqSize 設定為零。
uAssocReqSize
關聯作業中使用的要求框架長度。 框架的長度不包含 802.11 MAC 標頭。
如果 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_independent，迷你埠驅動程式必須將 uAssocReqSize 成員設定為零。
uAssocRespOffset
關聯作業中使用的回應框架位移。 框架不包含 802.11 MAC 標頭。
這個位移相對於緩衝區的開頭，其中包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構。
迷你埠驅動程式所傳回的關聯回應框架取決於 IEEE 802.11 dot11DesiredBSSType MIB 物件的設定：
如果 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_infrastructure， 框架是 802.11 關聯回應框架（如果 bReAssocReq為 true），或重新關聯回應框架 （如果 bReAssocReq 是 FALSE）從 AP 接收。 迷你埠驅動程序必須傳回 802.11 探查回應框架，該框架會根據關聯作業期間交換的資訊，傳送至關聯啟動器或由驅動程式建立。
如果 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_independent，迷你埠驅動程序必須將 uAssocRespOffset 成員設為零。
迷你埠驅動程序必須設定 uAssocRespOffset，並在關聯作業期間未收到回應框架時，將 uAssocRespSize 成員設為零。
uAssocRespSize
關聯作業中使用的回應框架長度。 框架的長度不包含 802.11 MAC 標頭。
如果 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_independent，迷你埠驅動程式必須將 uAssocRespSize 成員設定為零。
uBeaconOffset
上次收到的802.11指標或探查回應框架的位移。 迷你埠驅動程式在發出 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 狀態指示時，必須排除這些畫面的 802.11 MAC 標頭。
這個位移相對於緩衝區的開頭，其中包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構。
注意
如果關聯上使用的驗證演算法 Wi-Fi 受保護的存取 （WPA） 或 IEEE 802.11i 健全安全性網路關聯 （RSNA），迷你埠驅動程序必須一律傳回最後一個收到的 802.11 指標框架，且不得將 uBeaconOffset，uBeaconSize 成員設為零。
uBeaconSize
最後一個接收的長度為802.11指標框架。 框架的長度不包含 802.11 MAC 標頭。
uIHVDataOffset
IHV 所定義的專屬格式數據區塊位移。 IHV 可以針對與 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 狀態指示相關的任何用途使用此數據區塊。
這個位移相對於緩衝區的開頭，其中包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構。
如果迷你埠驅動程式未在 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 狀態指示中傳回 IHV 數據，則必須將 uIHVDataOffset 設為零。
uIHVDataSize
IHV 用於 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 狀態指示的數據區塊長度。 如果迷你埠驅動程式未在此指示中傳回 IHV 數據，則必須將 uIHVDataSize 設定為零。
AuthAlgo
802.11 月臺在關聯作業期間與AP或對等站解析的驗證演算法。 如需 AuthAlgo 成員資料類型的詳細資訊，請參閱 DOT11_AUTH_ALGORITHM。
如果 uStatus 未設定為 DOT11_ASSOCIATION_STATUS_SUCCESS，迷你埠驅動程式就必須將此成員設定為零。
UnicastCipher
802.11 月臺在關聯作業期間與 AP 或對等站解析的單播加密演算法。 如需 UnicastCipher 成員資料類型的詳細資訊，請參閱 DOT11_CIPHER_ALGORITHM。
如果 uStatus 未設定為 DOT11_ASSOCIATION_STATUS_SUCCESS，迷你埠驅動程式就必須將此成員設定為零。
MulticastCipher
802.11 月臺在關聯作業期間與AP或對等站解析的多播加密演算法。 如需 MulticastCipher 成員數據類型的詳細資訊，請參閱 DOT11_CIPHER_ALGORITHM
如果 uStatus 未設定為 DOT11_ASSOCIATION_STATUS_SUCCESS，迷你埠驅動程式就必須將此成員設定為零。
uActivePhyListOffset
802.11 月臺用來在 BSS 網路連線上傳送或接收封包的 PHY 標識符清單位移。
Extensible Station （ExtSTA） msDot11ActivePhyList MIB 物件也會參考使用中的 PHY 清單。
如需此 MIB 物件的詳細資訊，請參閱 OID_DOT11_ACTIVE_PHY_LIST。
使用中 PHY 清單中的項目可以是下列其中一個值：
- 由 ExtSTA msDot11DesiredPhyList MIB 物件所指定的 PHY 識別符。 如需此 MIB 物件的詳細資訊，請參閱 OID_DOT11_DESIRED_PHY_LIST。
- DOT11_PHY_ID_ANY。 如果 msDot11ActivePhyList MIB 物件指定 msDot11DesiredPhyList MIB 物件所指定的所有 PHY 標識符，迷你埠驅動程式就可以將專案設定為此值。 值為 DOT11_PHY_ID_ANY 的項目必須是使用中 PHY 清單中唯一的專案。
使用中 PHY 清單的位移相對於包含 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 結構的緩衝區開頭。
如果 uStatus 未設定為 DOT11_ASSOCIATION_STATUS_SUCCESS，迷你埠驅動程式必須將 uActivePhyListOffset uActivePhyListOffset ，並將 uActivePhyListSize 成員設定為零。
uActivePhyListSize
使用中 PHY 清單的長度。
uActivePhyListSize 成員必須是 sizeof(ULONG)的倍數。
bFourAddressSupported
布爾值，如果設定為 TRUE，則指定 802.11 月臺已與支援 BSS 網路中任何站臺上 ISO 第 2 層橋接之 ISO 第 2 層服務的 AP 相關聯，包括行動月臺和 AP。 此支持的判斷專屬於 IHV 的實作。
如果下列任一項成立，迷你埠驅動程序必須將 bFourAddressSupported 成員設定為 FALSE：
- IEEE 802.11 dot11DesiredBSSType MIB 物件會設定為 dot11_BSS_type_independent。
- 802.11 月臺未與支援 DS 服務的 AP 產生關聯，或無法判斷 AP 是否支援 DS 服務。
- uStatus 成員未設定為 DOT11_ASSOCIATION_STATUS_SUCCESS。
bPortAuthorized
布爾值，如果設定為 TRUE，則指定 802.11 月臺在關聯作業期間已成功執行埠授權。 埠授權可以根據 IEEE 802.1X/802.11i 標準或 IHV 開發的專屬演算法。
如果下列任一項成立，迷你埠驅動程式必須將 bPortAuthorized 設定為 FALSE：
- 802.11 月臺不會執行埠授權。
- uStatus 成員未設定為 DOT11_ASSOCIATION_STATUS_SUCCESS。
如需埠授權的詳細資訊，請參閱 Port-Based 網路存取。
ucActiveQoSProtocol
旗標，指定此關聯目前作用中的服務品質 （QoS） 通訊協定。 此成員為零（表示沒有使用 QoS 通訊協定）或下列其中一個旗標：
DOT11_QOS_PROTOCOL_FLAG_WMM
NIC 使用 802.11 WMM QoS 通訊協定。
DOT11_QOS_PROTOCOL_FLAG_11E
NIC 使用 802.11e QoS 通訊協定。
DSInfo
DOT11_DS_INFO值，指定 802.11 月臺是否從先前的關聯作業連接到相同的 DS。
DSInfo 成員會格式化為DOT11_DS_INFO列舉，指定下列值：
DOT11_DS_CHANGED
802.11 月臺在關聯作業之後已連線到新的 DS。
DOT11_DS_UNCHANGED
802.11 月臺會從關聯作業連線到相同的 DS。
DOT11_DS_UNKNOWN
迷你埠驅動程式無法判斷關聯作業之後 DS 是否已變更。
注意
如果 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_independent，迷你埠驅動程序必須將 dsInfo 設定為 DOT11_DS_UNKNOWN。
uEncapTableOffset
BSS 關聯之 IEEE EtherType 封裝清單的位移。
這個位移相對於緩衝區的開頭，其中包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構。 uEncapTableOffset 的值必須在 4 位元組界限上對齊。
迷你埠驅動程式會將此清單中的每個專案格式化為 DOT11_ENCAP_ENTRY 結構。
如需 EtherType 封裝清單的詳細資訊，請參閱 802.11 Payload Encapsulation。
uEncapTableSize
EtherType 封裝清單的長度。
MulticastMgmtCipher
NIC 為管理框架保護關聯選擇的多播加密演算法（交涉）。 如果交涉 MFP，則此成員應DOT11_CIPHER_ALGO_BIP。 如果未交涉 MFP，則此字段應DOT11_CIPHER_ALGO_NONE。
uAssocComebackTime
當 （re）關聯失敗並出現 802.11 原因代碼 30 時（「關聯要求暫時拒絕，請稍後再試一次。」）此成員表示存取點 （AP） 要求的關聯復出時間值。 回應關聯要求時，802.11 解除關聯原因碼會存在於 uStatus 的最低 16 位 中。
Windows 的自動連線服務會將 AP 新增至封鎖的清單，而不會嘗試至少重新連線指定的復出時間。 NIC 的行為就像是一般失敗的驗證，直到下一個連接順序開始為止。 在指定的逾時（復出）經過且連線程式停止之後，Windows 可能會找到更好的替代連線或回到此連線。 這個成員中設定的這個值應該使用 802.11 規格中定義的時間單位。 例如，TU。
言論
如果下列任一項成立，迷你埠驅動程序必須將 uEncapTableOffset，並將 uEncapTableSize 成員設定為零：
- BSS 關聯不需要變更作系統的預設 EtherType 封裝清單。
- uStatus 成員未設定為 DOT11_ASSOCIATION_STATUS_SUCCESS。
- Extensible Station （ExtSTA） dot11DesiredBSSType 管理資訊基底 （MIB） 物件設定為 dot11_BSS_type_independent。
如需 IEEE 802.11 dot11DesiredBSSType MIB 物件的詳細資訊，請參閱 OID_DOT11_DESIRED_BSS_TYPE。
如需關聯作業的詳細資訊，請參閱 關聯作業。
當存取點 （AP） 和 STA 在 （re）關聯程式 （亦即） 關聯程序期間，在各自的 RSN IES 中將管理框架保護功能 （MFPC） 字段設定為 1 時，會交涉管理框架保護 AP 和 （re）關聯要求的指標或探查回應，雙方確認管理框架保護能力位在 4 向交握中設定為 1（802.11i 4 向交握的訊息 M2 和 M3）。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 8 和更新版本的 Windows作系統。 |
| 標頭 | windot11.h （包括 Ndis.h） |