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 结构。

微型端口驱动程序必须将标头的成员设置为以下值：

类型

此成员必须设置为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结构的长度（以字节为单位），则微型端口驱动程序必须执行以下作才能完成成功的查询请求：
- 对于DOT11_CIPHER_ALGORITHM_LIST结构，请将 uNumOfEntries，uTotalNumOfEntries 成员设置为 AlgorithmIds 数组中的条目总数。
- 对于 OidRequest 参数，请将 BytesNeeded 成员设置为零，并将 BytesWritten 成员设置为整个DOT11_CIPHER_ALGORITHM_LIST结构的长度（以字节为单位）。微型端口驱动程序还必须将整个DOT11_CIPHER_ALGORITHM_LIST结构复制到 InformationBuffer 成员。
- 从其 MiniportOidRequest 函数返回NDIS_STATUS_SUCCESS。