DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 結構 (windot11.h)

發行項
02/27/2024

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

DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 結構會指定從基礎結構 BSS 上的對等站接收關聯要求之後，由 802.11 月臺執行的關聯作業結果。

語法

typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  DOT11_MAC_ADDRESS      PeerMacAddr;
  ULONG                  uStatus;
  UCHAR                  ucErrorSource;
  BOOLEAN                bReAssocReq;
  BOOLEAN                bReAssocResp;
  ULONG                  uAssocReqOffset;
  ULONG                  uAssocReqSize;
  ULONG                  uAssocRespOffset;
  ULONG                  uAssocRespSize;
  DOT11_AUTH_ALGORITHM   AuthAlgo;
  DOT11_CIPHER_ALGORITHM UnicastCipher;
  DOT11_CIPHER_ALGORITHM MulticastCipher;
  ULONG                  uActivePhyListOffset;
  ULONG                  uActivePhyListSize;
  ULONG                  uBeaconOffset;
  ULONG                  uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;

成員

Header

DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS 結構的型別、修訂和大小。此成員的格式為 NDIS_OBJECT_HEADER 結構。

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

類型

此成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。

修訂版

此成員必須設定為 DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1。

大小

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

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

PeerMacAddr

媒體訪問控制 (MAC) 傳送關聯要求的對等站位址。

uStatus

與對等站關聯的狀態。如果為零，則關聯會成功。如果非零，關聯就會失敗。

ucErrorSource

若為 uStatus 的非零值，此成員會指出防止關聯的錯誤來源。 NIC 必須將 ucErrorSource 設定為下列其中一個值：

DOT11_ASSOC_ERROR_SOURCE_OS

迷你埠驅動程式因為系統錯誤而拒絕關聯程式，例如記憶體不足錯誤。在此情況下， uStatus 應該設定為從操作系統傳回的NDIS_STATUS_XXX或NTSTATUS_XXX程序代碼。

DOT11_ASSOC_ERROR_SOURCE_REMOTE

AP 或對等站已拒絕關聯程式。在此情況下， uStatus 應該設定為 802.11 狀態代碼，形成 802.11 驗證框架、關聯回應框架或重新關聯回應框架。 IEEE 802.11-2003 規格中的表 19 包含所有可能的值。迷你埠驅動程式也可以在修改此 IEEE 規格中傳回新值。

DOT11_ASSOC_ERROR_SOURCE_OTHER

關聯因 IHV 特定原因而失敗。在此情況下， uStatus 包含 IHV 所指定的非零值。

bReAssocReq

布爾值，指出來自對等站的要求是否為重新關聯要求。

bReAssocResp

布爾值，指出來自 NIC 的回應是否為重新關聯要求。

uAssocReqOffset

關聯作業中使用的要求框架位移。框架包含資訊元素 (IES) ，但不包含 802.11 MAC 標頭。

uAssocReqSize

在關聯作業中使用的要求框架長度，以位元組為單位。框架包含資訊元素 (IES) ，但不包含 802.11 MAC 標頭。

uAssocRespOffset

在關聯作業中使用的回應框架位移。框架包含資訊元素 (IES) ，但不包含 802.11 MAC 標頭。

uAssocRespSize

在關聯作業中使用的回應框架長度，以位元組為單位。框架包含資訊元素 (IES) ，但不包含 802.11 MAC 標頭。

AuthAlgo

802.11 月臺在關聯作業期間與對等站一起解析的驗證演算法。如需 AuthAlgo 成員數據類型的詳細資訊，請參閱 DOT11_AUTH_ALGORITHM。

注意如果 uStatus 未設定為零，迷你埠驅動程式必須將這個成員設定為零。

UnicastCipher

802.11 月臺在關聯作業期間與對等站一起解析的單播加密演算法。如需 UnicastCipher 成員數據類型的詳細資訊，請參閱 DOT11_CIPHER_ALGORITHM。

注意如果 uStatus 未設定為零，迷你埠驅動程式必須將這個成員設定為零。

MulticastCipher

802.11 月臺在關聯作業期間與 AP 或對等站一起解析的多播加密演算法。如需 MulticastCipher 成員數據類型的詳細資訊，請參閱 DOT11_CIPHER_ALGORITHM。

注意如果 uStatus 未設定為零，迷你埠驅動程式必須將這個成員設定為零。

uActivePhyListOffset

802.11 月臺用來在 BSS 網路連線上傳送或接收封包的 PHY 標識符清單 (識別碼的位移) 。每個專案都是ULONG值。

Extensible Station (ExtSTA) msDot11ActivePhyList MIB objec 也會參考使用中的 PHY 列表。

使用中 PHY 清單中的項目可以是下列其中一個值：

由 Extensible Station (ExtSTA) msDot11DesiredPhyList 管理資訊基底所指定的 PHY 標識符， (MIB) 物件。如需此MIB對象的詳細資訊，請參閱 OID_DOT11_DESIRED_PHY_LIST。
DOT11_PHY_ID_ANY的 PHY 識別碼。如果 ExtSTA msDot11ActivePhyList MIB 物件指定 msDot11DesiredPhyList MIB 物件所指定的所有 PHY 標識符，迷你埠驅動程式就可以將專案設定為這個值。如需此MIB對象的詳細資訊，請參閱 OID_DOT11_ACTIVE_PHY_LIST。
注意值為 DOT11_PHY_ID_ANY 的項目必須是使用中 PHY 清單中的唯一專案。

使用中 PHY 清單的位移相對於包含DOT11_ASSOCIATION_COMPLETION_PARAMETERS結構的緩衝區開頭。

注意如果 uStatus 未設定為零，迷你埠驅動程式必須將這個成員設定為零。

uActivePhyListSize

使用中 PHY 清單的長度，以位元組為單位。 uActivePhyListSize 成員必須是的sizeof(ULONG)倍數。

注意如果 uStatus 未設定為零，迷你埠驅動程式必須將這個成員設定為零。

uBeaconOffset

上次傳輸 802.11 指標框架的位移，以位元組為單位。

指標框架包含指標框架標頭和所有資訊元素 (I) ，但不包含 802.11 MAC 標頭。指標框架格式是以 ISO/IEC 8802-11 定義。

指標框架應該是驅動程式使用的最新框架，不同之處在於，與數據框架流程控件不同之即時參數或 IDE，或用戶端關聯狀態，例如時間戳、無線電參數、TIM、ERP 和 HT IE，不需要精確。

注意如果 uStatus 未設定為零，迷你埠驅動程式必須將這個成員設定為零。

uBeaconSize

上次傳輸的 802.11 指標框架長度，以位元組為單位。

指標框架包含指標框架標頭和所有資訊元素 (I) ，但不包含 802.11 MAC 標頭。指標框架格式是以 ISO/IEC 8802-11 定義。

注意如果 uStatus 未設定為零，迷你埠驅動程式必須將這個成員設定為零。

備註

原生 802.11 迷你埠驅動程式會在驅動程式建立時包含DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS結構 NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION 狀態指示。

NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION狀態指示會標示 關聯指示區塊的結尾。如果關聯成功，NIC 必須在成功將對應的關聯回應框架傳送至原本要求關聯的月臺之後，發出NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION指示。如果關聯失敗，NIC 必須發出NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION指示是否成功傳送回應。失敗可能是因為 NIC 或作業系統拒絕關聯要求，或因為與 802.11 架構無關的失敗。