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結構的長度、位元組，則 miniport 驅動程式必須執行下列動作，才能完成成功的查詢要求：
- 針對DOT11_SUPPORTED_ANTENNA_LIST結構，請將 uNumOfEntries 和 uTotalNumOfEntries 成員設定為 dot11SupportedAntenna 陣列 中的項目總數。
- 針對 OidRequest 參數，將 BytesNeededed 成員設為零，並將 BytesWritten 成員設定為整個DOT11_SUPPORTED_ANTENNA_LIST結構的長度，以位元組為單位。 迷你埠驅動程式也必須將整個DOT11_SUPPORTED_ANTENNA_LIST結構複製到 InformationBuffer 成員。
- 從其 MiniportOidRequest 函式傳回NDIS_STATUS_SUCCESS。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
| 標頭 | windot11.h （包括 Ndis.h） |