Структура DOT11_BSS_ENTRY (windot11. h)

Важно! встроенный интерфейс беспроводной локальной сети 802,11 не рекомендуется использовать в Windows 10 и более поздних версиях. Используйте вместо него интерфейс драйвера устройства (WDI) WLAN. дополнительные сведения о WDI см. в статье модель драйвера универсальной Windows WLAN.
Структура DOT11_BSS_ENTRY определяет кадр маяка или ответа IEEE 802,11, полученный на станции 802,11 во время последней операции сканирования.

Синтаксис

typedef struct DOT11_BSS_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  BOOLEAN                           bInRegDomain;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBufferLength;
  UCHAR                             ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;

Члены

uPhyId

Идентификатор PHY, который используется станцией 802,11 для обнаружения сети BSS. Идентификатор PHY — это индекс в списке поддерживаемых данных инвентаризации, возвращенных драйвером с помощью запроса OID_DOT11_SUPPORTED_PHY_TYPES.

Этот идентификатор не должен быть DOT11_PHY_ID_ANY.

PhySpecificInfo

Атрибуты PHY, на которые ссылается элемент уфид . ФиспеЦифиЦинфо форматируется как объединение DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO .

dot11BSSID

MAC-адрес точки доступа (для сетей с инфраструктурой BSS) или одноранговой станции (для независимых сетей BSS), которые отправили кадр сигналов маяка 802,11 или пробного ответа, полученного на станции 802,11 при сканировании. Тип данных для этого элемента — структура DOT11_MAC_ADDRESS .

dot11BSSType

Тип сети BSS.

Тип данных этого элемента — это перечисление DOT11_BSS_TYPE . Драйвер минипорта не должен присвоить этому члену значение dot11_BSS_type_any .

lRSSI

Полученное значение индикатора силы сигнала (RSSI) в единицах децибел, на которые ссылается 1,0 МВт (dBm), как обнаружено станцией 802,11 для ТД или одноранговой станции.

uLinkQuality

Значение качества связи в диапазоне от 0 до 100. Значение 100 указывает самое высокое качество связи. Дополнительные сведения об определении качества связи см. в разделе операции по качеству связи.

bInRegDomain

Этот член указывает, работает ли точка AP или одноранговая станция в домене соответствия требованиям, определяемым входной строкой страны. Для установки этого члена драйвер минипорта должен следовать приведенным ниже рекомендациям.

  • Если станция 802,11 не поддерживает несколько нормативных доменов, установите для члена значение true. Дополнительные сведения о разных доменах норм см. в разделе OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
  • Если входная строка страны имеет все нули, присвойте элементу значение true.
  • Если точка AP или одноранговая станция не работает на канале, который является допустимым для доменных норм, указанных во входной строке Country, установите для элемента значение false.
  • Если кадр ответа маяка или пробы 802,11, полученный от ТД или одноранговой станции, не содержит элемент сведений о стране (IE), установите для элемента значение true.

    Дополнительные сведения о стране IE см. в предложении 7.3.2.12 стандарта IEEE 802.11 d-2001.

  • Если кадр ответа 802,11 или пробы, полученный от ТД или одноранговой станции, включает в себя страну IE, установите для элемента значение false , если значение поля Строка страны не совпадает с входной строкой страны.
  • Во всех остальных случаях задайте для элемента значение true .

usBeaconPeriod

Значение поля интервала маяка из кадра ответов 802,11 или пробы.

ullTimestamp

Значение поля timestamp из кадра ответов 802,11 или пробы.

ullHostTimestamp

Отметка времени, разрешенная при вызове ндисжеткуррентсистемтиме, которая регистрирует, когда станция 802,11 получила кадр ответа 802,11 или сигнала пробы.

usCapabilityInformation

Значение поля сведений о возможности из кадра ответов 802,11 или пробы.

uBufferLength

Длина массива укбуффер в байтах в структуре DOT11_BSS_ENTRY. улбуфферленгс должен быть точной длиной данных в массиве укбуффер и не должен содержать заполнения для выравнивания.

ucBuffer

Элементы сведений переменной длины из кадров ответов на маяки 802,11 и пробы. Для каждого BSS они должны быть из последнего кадра маяка или пробного ответа, полученного от сети BSS. Если IE доступен только в одном кадре, драйвер минипорта должен выполнить слияние IE с другими классами из последнего полученного кадра маяка или пробного ответа.

Если сетевая карта находится в режиме расширенной точки доступа (Екстап), список BSS должен содержать запись BSS, созданную сетевым адаптером.

Дополнительные сведения о полях в кадрах ответов IEEE 802,11 или пробных откликов см. в предложении 8,4 стандарта IEEE 802.11-2012.

Примечания

Когда станция 802,11 выполняет операцию сканирования, драйвер минипорта машинного кода 802,11 кэширует полученный 802,11 маяк и кадры ответа пробы. Дополнительные сведения об операции сканирования см. в разделе машинная операция сканирования 802,11.

После того, как станция 802,11 завершит операцию сканирования, драйвер минипорта возвращает список кэшированных кадров маяка и ответа пробы при запросе OID_DOT11_ENUM_BSS_LIST. Отдельная структура DOT11_BSS_ENTRY отформатирована для каждого кадра сигналов маяка и пробного ответа.

Требования

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

См. также

DOT11_BSS_TYPE

DOT11_BSS_LIST

OID_DOT11_SUPPORTED_PHY_TYPES

OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED

DOT11_MAC_ADDRESS

DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO

ндисжеткуррентсистемтиме

OID_DOT11_ENUM_BSS_LIST