структура DOT11_SUPPORTED_ANTENNA_LIST (windot11.h)

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте WLAN Device Driver Interface (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 драйвер мини-порта должен убедиться, что элемент InformationBuffer параметра OidRequest функции MiniportOidRequest достаточно велик, чтобы вернуть всю структуру DOT11_SUPPORTED_ANTENNA_LIST, включая все записи в массиве dot11SupportedAntenna. Значение элемента InformationBufferLength параметра OidRequest определяет, что должен делать драйвер мини-порта, как показано в следующем списке:

  • Если значение элемента InformationBufferLength меньше длины (в байтах) всей структуры DOT11_SUPPORTED_ANTENNA_LIST, драйвер мини-порта должен выполнить следующие действия:
    • Задайте для элемента uNumOfEntries нулевое значение.
    • Задайте для элемента uTotalNumOfEntries количество записей в массиве dot11SupportedAntenna .

      Для параметра OidRequest задайте для элемента BytesWritten значение 0, а для элемента BytesNeeded — длину всей структуры DOT11_PHY_ID_LIST в байтах.

    • Завершите запрос, возвращая NDIS_STATUS_BUFFER_OVERFLOW из функции MiniportOidRequest .
  • Если значение элемента InformationBufferLength больше или равно длине (в байтах) всей структуры DOT11_SUPPORTED_ANTENNA_LIST, драйвер мини-порта должен выполнить следующие действия для успешного выполнения запроса:
    • Для структуры DOT11_SUPPORTED_ANTENNA_LIST задайте для элементов uNumOfEntries и uTotalNumOfEntries общее количество записей в массиве dot11SupportedAntenna .
    • Для параметра OidRequest задайте для элемента BytesNeeded значение ноль, а для элемента BytesWritten — длину всей структуры DOT11_SUPPORTED_ANTENNA_LIST в байтах. Драйвер мини-порта также должен скопировать всю структуру DOT11_SUPPORTED_ANTENNA_LIST в элемент InformationBuffer .
    • Возвращает NDIS_STATUS_SUCCESS из функции MiniportOidRequest .

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть windot11.h (включая Ndis.h)

См. также раздел

DOT11_SUPPORTED_ANTENNA

OID_DOT11_SUPPORTED_TX_ANTENNA

OID_DOT11_SUPPORTED_RX_ANTENNA