DOT11_CIPHER_ALGORITHM_LIST結構（windot11.h）

發行項
02/07/2025

重要

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

DOT11_CIPHER_ALGORITHM_LIST 結構會定義可在802.11站上啟用的 DOT11_CIPHER_ALGORITHM 結構清單。

語法

typedef struct DOT11_CIPHER_ALGORITHM_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_CIPHER_ALGORITHM AlgorithmIds[1];
} DOT11_CIPHER_ALGORITHM_LIST, *PDOT11_CIPHER_ALGORITHM_LIST;

成員

Header

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

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

類型

這個成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。

校訂

這個成員必須設定為 DOT11_CIPHER_ALGORITHM_LIST_REVISION_1。

大小

這個成員必須設定為sizeof（DOT11_CIPHER_ALGORITHM_LIST）。

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

uNumOfEntries

AlgorithmIds 陣列中的項目數。

uTotalNumOfEntries

AlgorithmIds 陣列可以包含的最大項目數目。

AlgorithmIds[1]

加密演算法，由 DOT11_CIPHER_ALGORITHM 列舉值定義。

加密演算法的清單會依喜好設定排序。 AlgorithmIds [0] 定義具有最高喜好設定的加密演算法。

言論

當 OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR 或 OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR查詢迷你埠驅動程式時，迷你埠驅動程式會傳回DOT11_CIPHER_ALGORITHM_LIST結構。

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

如果 InformationBufferLength 成員的值小於整個DOT11_CIPHER_ALGORITHM_LIST結構的長度，迷你埠驅動程式必須執行下列動作：
- 針對 OidRequest 參數，將 BytesWritten 成員設定為零，並將 BytesNeeded 成員設定為整個DOT11_CIPHER_ALGORITHM_LIST結構的長度，以位元組為單位。
- 從其 MiniportOidRequest 函式傳回NDIS_STATUS_BUFFER_OVERFLOW，以失敗查詢要求。
如果 InformationBufferLength 成員的值大於或等於整個DOT11_CIPHER_ALGORITHM_LIST結構的長度，則 miniport 驅動程式必須執行下列動作，才能完成成功的查詢要求：
- 針對 DOT11_CIPHER_ALGORITHM_LIST 結構，將 uNumOfEntries 和 uTotalNumOfEntries 成員設定為 AlgorithmIds 陣列中的項目總數。
- 針對 OidRequest 參數，將 BytesNeededed 成員設定為零，並將 BytesWritten 成員設定為整個DOT11_CIPHER_ALGORITHM_LIST結構的長度，以位元組為單位。迷你埠驅動程式也必須將整個DOT11_CIPHER_ALGORITHM_LIST結構複製到 InformationBuffer 成員。
- 從其 MiniportOidRequest 函式傳回NDIS_STATUS_SUCCESS。