DOT11_SUPPORTED_ANTENNA_LIST 結構 (windot11.h)

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

 

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 時，迷你埠驅動程式必須確認 MiniportOidRequest 函式的 OidRequest 參數的 InformationBuffer 成員夠大，足以傳回整個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 (include Ndis.h)

另請參閱

DOT11_SUPPORTED_ANTENNA

OID_DOT11_SUPPORTED_TX_ANTENNA

OID_DOT11_SUPPORTED_RX_ANTENNA