DOT11_ASSOCIATION_COMPLETION_PARAMETERS 結構 (windot11.h)

發行項
02/27/2024

重要

原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。請改用 WLAN 設備驅動器介面 (WDI) 。如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

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

適用於獨立 BSS (IBSS (IBSS) 網路) 網路) 802.11 月台嘗試連線之基礎結構 BSS 網路) 或對等 (站的存取 (點) (位址的媒體 (訪問控制) 位址。

uStatus

關聯作業的完成狀態，由針對 DOT11_ASSOC_STATUS 定義的值所指定。

bReAssocReq

布爾值，指出802.11月臺是否將802.11關聯或重新關聯框架傳送至AP。如果為 TRUE，802.11 月臺會將 801.11 重新關聯要求框架傳送至 AP。如果為 FALSE，802.11 月臺會將 802.11 關聯要求框架傳送至 AP。

只有在 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_infrastructure 時，bReAssocReq 成員的 TRUE 值才有效。

bReAssocResp

布爾值，指出 802.11 月臺是否從 AP 收到 802.11 關聯或重新關聯框架。如果為 TRUE，802.11 月臺收到來自 AP 的 802.11 重新關聯回應框架。如果 為 FALSE，則 802.11 月臺收到來自 AP 的 802.11 關聯回應框架。

只有在 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_infrastructure 時，bReAssocResp 成員的 TRUE 值才有效。

uAssocReqOffset

關聯作業中使用的要求框架位移。框架不包含 802.11 MAC 標頭。

這個位移相對於包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構的緩衝區開頭。

迷你埠驅動程式所傳回的關聯要求框架取決於 IEEE 802.11 dot11DesiredBSSType MIB 物件的設定：

如果 dot11DesiredBSSType MIB 物件設定為 dot11_BSS_type_infrastructure，則如果 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，則如果 bReAssocReq 為 TRUE) 或 Reassociation 回應 ( (框架，則如果 bReAssocReq 為 FALSE) ，則框架為 FALSE) 。迷你埠驅動程式必須傳回 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 和 uActivePhyListSize 成員設定為零。

uActivePhyListSize

使用中 PHY 清單的長度。 uActivePhyListSize 成員必須是的sizeof(ULONG)倍數。

bFourAddressSupported

布爾值，如果設定為 TRUE，則指定 802.11 月臺與支援 BSS 網路中任何站臺上 ISO 第 2 層橋接的散發系統 (DS) 服務相關聯，包括行動月臺和 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。

如需埠授權的詳細資訊，請參閱埠型網路存取。

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 承載封裝。

uEncapTableSize

EtherType 封裝清單的長度。

MulticastMgmtCipher

NIC 選擇多播加密演算法， (交涉管理畫面格保護) (MFP) 關聯。如果交涉 MFP，則此成員應該DOT11_CIPHER_ALGO_BIP。如果未交涉 MFP，此字段應該DOT11_CIPHER_ALGO_NONE。

uAssocComebackTime

當重新 () 關聯失敗，原因代碼為 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 在其各自的 RSN IDE 中，將 [管理畫面格保護支援 (MFPC) ] 字段設定為 1，也就是 (重新) 關聯程式 (。 AP 和 (的指標或探查回應會重新) STA) 的關聯要求，且雙方在 4 向交握 (訊息中確認管理畫面格保護支援位設為 1802.11i 4 向交握的 M2 和 M3) 。