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

Статья
08/08/2023

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.

Структура 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 — это индекс в списке поддерживаемых объектов PHY, возвращаемых драйвером через запрос OID_DOT11_SUPPORTED_PHY_TYPES.

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

PhySpecificInfo

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

dot11BSSID

Mac-адрес точки доступа (AP) (для инфраструктурных сетей 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 для точки AP или одноранговой станции.

uLinkQuality

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

bInRegDomain

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

Если станция 802.11 не поддерживает несколько нормативных доменов, задайте для элемента значение TRUE. Дополнительные сведения о нескольких нормативных доменах см. в разделе OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
Если строка входной страны равна нулям, задайте для элемента значение TRUE.
Если AP или одноранговая станция не работает в канале, который является допустимым для нормативного домена, указанного в строке входной страны, задайте для элемента значение FALSE.
Если кадр 802.11 Beacon или Probe Response, полученный от точки ap или одноранговой станции, не содержит элемент Сведений о стране (IE), задайте для элемента значение TRUE.
Дополнительные сведения о country IE см. в разделе 7.3.2.12 стандарта IEEE 802.11d-2001.
Если кадр маяка 802.11 или отклик пробы, полученный от точки ap или одноранговой станции, содержит IE страны, установите для элемента значение FALSE , если значение вложенного поля Строка страны не равно строке входной страны.
Во всех остальных случаях задайте для элемента значение TRUE .

usBeaconPeriod

Значение поля Интервал маяка из кадра 802.11 Маяк или Ответ пробы.

ullTimestamp

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

ullHostTimestamp

Метка времени, разрешенная с помощью вызова NdisGetCurrentSystemTime, который записывает, когда станция 802.11 получила кадр маяка 802.11 или отклик пробы.

usCapabilityInformation

Значение поля Сведения о возможности из кадра маяка или ответа пробы 802.11.

uBufferLength

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

ucBuffer[1]

Информационные элементы переменной длины (IEs) из кадров маяка 802.11 или отклика пробы. Для каждого BSS IEs должны быть из последнего кадра ответа маяка или пробы, полученного из этой сети BSS. Если IE доступен только в одном кадре, драйвер мини-порта должен объединить IE с другими IES из последнего полученного кадра маяка или отклика пробы.

Если сетевой адаптер находится в режиме op extap, список BSS должен содержать запись для созданного сетевого адаптера BSS.

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

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

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

Требования

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