共用方式為

DOT11_AUTH_CIPHER_PAIR_LIST結構 （windot11.h）

  • 發行項

重要

WiFiCx 是 Windows 11 中發行的新 Wi-Fi 驅動程式模型。 我們建議您使用WiFiCx來利用最新的功能。 WDI 驅動程式模型現在處於維護模式，而且只會收到高優先順序的修正。

DOT11_AUTH_CIPHER_PAIR_LIST 結構會定義DOT11_AUTH_CIPHER_PAIR結構的清單。

語法

typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;

成員

Header

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

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

類型

這個成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。

校訂

這個成員必須設定為 DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1。

大小

這個成員必須設定為 sizeof(DOT11_AUTH_CIPHER_PAIR_LIST)。

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

uNumOfEntries

AuthCipherPair s 陣列中的項目數。

uTotalNumOfEntries

AuthCipherPairs 陣列可以包含的項目數目上限。

AuthCipherPairs[1]

清單 DOT11_AUTH_CIPHER_PAIR 結構。

言論

迷你埠驅動程式會在其中一個查詢時傳回DOT11_AUTH_CIPHER_PAIR_LIST結構 OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR 或 OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR。

查詢這些 OID 時，迷你埠驅動程式必須確認 InformationBufferMiniportOidRequest 函式 OidRequest 參數的大小足以傳回整個DOT11_AUTH_CIPHER_PAIR_LIST結構，包括 AuthCipherPairs 陣組中的所有專案。 OidRequest 參數 InformationBufferLength 成員的值會決定迷你埠驅動程序必須執行的動作，如下列清單所示：

  • 如果 InformationBufferLength 成員的值小於整個DOT11_AUTH_CIPHER_PAIR_LIST結構的長度，miniport 驅動程式必須執行下列動作：
    • 針對 OidRequest 參數，將 BytesWritten 成員設為零，並將 BytesNeeded 成員設定為整個DOT11_AUTH_CIPHER_PAIR_LIST結構的長度，以位元組為單位。
    • 從其 MiniportOidRequest 函式傳回NDIS_STATUS_BUFFER_OVERFLOW，以失敗查詢要求。
  • 如果 InformationBufferLength 成員的值大於或等於整個DOT11_AUTH_CIPHER_PAIR_LIST結構的長度、位元組，則miniport驅動程式必須執行下列動作，才能完成成功的查詢要求：
    • 針對 DOT11_AUTH_CIPHER_PAIR_LIST 結構，請將 uNumOfEntries 和 uTotalNumOfEntries 成員設定為 AuthCipherPairs 陣列中的項目總數。
    • 針對 OidRequest 參數，將 BytesNeededed 成員設為零，並將 BytesWritten 成員設定為整個DOT11_AUTH_CIPHER_PAIR_LIST結構的長度，以位元組為單位。 迷你埠驅動程式也必須將整個DOT11_AUTH_CIPHER_PAIR_LIST結構複製到 InformationBuffer 成員。
    • 從其 MiniportOidRequest 函式傳回NDIS_STATUS_SUCCESS。
從 Windows 7 開始，802.11 迷你埠驅動程式可以報告DOT11_AUTH_CIPHER_PAIR_LIST中支持驗證和加密演算法組的任何組合。 不過，如果作系統啟動軟體 AP，它只會啟用 DOT11_AUTH_ALGO_RSNA_PSK 驗證演算法和 DOT11_CIPHER_ALGO_CCMP 加密演算法。 若要支援軟體 AP，迷你埠驅動程式必須支援此驗證/加密組。

如果在以可延伸AP模式運作的NIC上啟用WPS，迷你埠驅動程序必須允許對等站使用 Open System Authentication 或 有線對等隱私權 （WEP） 演算法，不論啟用的授權和加密演演算法為何，都能夠與可延伸 AP 產生關聯。 如需 WPS 和可延伸 AP 的詳細資訊，請參閱 OID_DOT11_WPS_ENABLED。

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
標頭 windot11.h （包括 Ndis.h）

另請參閱

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER