DOT11_SUPPORTED_ANTENNA_LIST结构（windot11.h）
重要
WiFiCx 是 Windows 11 中发布的新 Wi-Fi 驱动程序模型。 建议使用 WiFiCx 来利用最新功能。 WDI 驱动程序模型现在处于维护模式，并且仅接收高优先级修补程序。
DOT11_SUPPORTED_ANTENNA_LIST结构指定可用于接收或传输作的天线列表。
语法
typedef struct _DOT11_SUPPORTED_ANTENNA_LIST {
ULONG uNumOfEntries;
ULONG uTotalNumOfEntries;
DOT11_SUPPORTED_ANTENNA dot11SupportedAntenna[1];
} DOT11_SUPPORTED_ANTENNA_LIST, *PDOT11_SUPPORTED_ANTENNA_LIST;
成员
uNumOfEntries
dot11SupportedAntenna 数组 中的条目数。 uNumOfEntries 成员的零值表示空列表。
uTotalNumOfEntries
dot11SupportedAntenna 数组可以包含的最大条目数。
dot11SupportedAntenna[1]
支持的天线列表。 此列表中的每个元素的格式设置为 DOT11_SUPPORTED_ANTENNA 结构。
言论
微型端口驱动程序在任一查询时返回DOT11_SUPPORTED_ANTENNA_LIST结构 OID_DOT11_SUPPORTED_RX_ANTENNA 或 OID_DOT11_SUPPORTED_TX_ANTENNA。
查询这些 OID 时，微型端口驱动程序必须验证 InformationBufferMiniportOidRequest 函数的 OidRequest 参数的大小足以返回整个DOT11_SUPPORTED_ANTENNA_LIST结构，包括 dot11SupportedAntenna 数组中的所有条目。 OidRequest 参数的 InformationBufferLength 成员的值决定了微型端口驱动程序必须执行的作，如下所示：
-
如果 InformationBufferLength 成员的值小于整个DOT11_SUPPORTED_ANTENNA_LIST结构的长度（以字节为单位），微型端口驱动程序必须执行以下作：
- 将 uNumOfEntries 成员设置为零。
-
将 uTotalNumOfEntries 成员设置为 dot11SupportedAntenna 数组 中的条目数。
对于 OidRequest 参数，请将 BytesWritten 成员设置为零，并将 BytesNeeded 成员设置为整个DOT11_PHY_ID_LIST结构的长度（以字节为单位）。
- 通过从其 MiniportOidRequest 函数返回NDIS_STATUS_BUFFER_OVERFLOW来失败查询请求。
-
如果 InformationBufferLength 成员的值大于或等于整个DOT11_SUPPORTED_ANTENNA_LIST结构的长度（以字节为单位）：微型端口驱动程序必须执行以下作才能完成成功的查询请求：
- 对于DOT11_SUPPORTED_ANTENNA_LIST结构，请将 uNumOfEntries 和 uTotalNumOfEntries 成员设置为 dot11SupportedAntenna 数组 中的条目总数。
- 对于 OidRequest 参数，请将 BytesNeeded 成员设置为零，并将 BytesWritten 成员设置为整个DOT11_SUPPORTED_ANTENNA_LIST结构的长度（以字节为单位）。 微型端口驱动程序还必须将整个DOT11_SUPPORTED_ANTENNA_LIST结构复制到 InformationBuffer 成员。
- 从其 MiniportOidRequest 函数返回NDIS_STATUS_SUCCESS。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows Vista 和更高版本的 Windows作系统中可用。 |
| 标头 | windot11.h （包括 Ndis.h） |