структура WLAN_BSS_ENTRY (wlanapi.h)

Структура WLAN_BSS_ENTRY содержит сведения о базовом наборе служб (BSS).

Синтаксис

typedef struct _WLAN_BSS_ENTRY {
  DOT11_SSID        dot11Ssid;
  ULONG             uPhyId;
  DOT11_MAC_ADDRESS dot11Bssid;
  DOT11_BSS_TYPE    dot11BssType;
  DOT11_PHY_TYPE    dot11BssPhyType;
  LONG              lRssi;
  ULONG             uLinkQuality;
  BOOLEAN           bInRegDomain;
  USHORT            usBeaconPeriod;
  ULONGLONG         ullTimestamp;
  ULONGLONG         ullHostTimestamp;
  USHORT            usCapabilityInformation;
  ULONG             ulChCenterFrequency;
  WLAN_RATE_SET     wlanRateSet;
  ULONG             ulIeOffset;
  ULONG             ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;

Члены

dot11Ssid

SSID точки доступа (AP) или одноранговой станции, связанной с BSS. Тип данных для этого элемента является DOT11_SSID структурой.

uPhyId

Идентификатор PHY, используемый интерфейсом беспроводной локальной сети для обнаружения сети BSS.

dot11Bssid

Mac-адрес точки доступа к инфраструктуре BSS или одноранговой станции для независимых сетей BSS (нерегламентированных сетей), отправляющих 802.11 маяк или кадр ответа пробы, полученный интерфейсом беспроводной локальной сети во время сканирования. Тип данных для этого элемента является DOT11_MAC_ADDRESS структурой.

dot11BssType

Тип сети BSS. Тип данных для этого элемента является значением перечисления DOT11_BSS_TYPE.

Этот элемент может иметь одно из следующих значений.

dot11BssPhyType

Тип PHY для этой сети. Тип данных для этого элемента является значением перечисления DOT11_PHY_TYPE .

lRssi

Значение полученного индикатора мощности сигнала (RSSI) в единицах децибел, на которые ссылается 1,0 милливатта (дБм), обнаруженное драйвером интерфейса беспроводной локальной сети для ap или одноранговой станции.

uLinkQuality

Качество связи, сообщаемое драйвером интерфейса беспроводной локальной сети. Значение качества связи колеблется в диапазоне от 0 до 100. Значение 100 указывает наивысшее качество связи.

bInRegDomain

Значение типа , указывающее, работает ли AP или одноранговая станция в пределах нормативного домена, определенного страной или регионом.

Если драйвер интерфейса беспроводной локальной сети не поддерживает несколько нормативных доменов, для этого элемента задано значение TRUE.

Если кадр маяка или отклика пробы 802.11, полученный от точки доступа или одноранговой станции, не содержит элемент сведений о стране (IE), этот элемент имеет значение TRUE.

Если кадр маяка 802.11 или ответа зонда, полученный от точки доступа или одноранговой станции, содержит IE страны, этот элемент имеет значение FALSE , если значение вложенного поля Строка страны не равно строке входной страны.

usBeaconPeriod

Значение поля Интервал маяка из кадра 802.11 Beacon или Probe Response, полученного интерфейсом беспроводной локальной сети.

Интервал между временем передачи целевого маяка составляет 1024 микросекунда. Эти сведения извлекаются из пакета маяка, отправленного точкой доступа в сети BSS инфраструктуры, или из ответа пробы из точки доступа или одноранговой станции в ответ на запрос пробы от клиента беспроводной локальной сети.

Стандарт IEEE 802.11 определяет единицу времени, равную 1024 микросекундам. Этот блок был определен таким образом, чтобы его можно было легко реализовать в оборудовании.

ullTimestamp

Значение поля Метка времени из кадра 802.11 Маяк или Ответ пробы, полученного интерфейсом беспроводной локальной сети.

ullHostTimestamp

Значение метки времени узла, которое записывает, когда интерфейс беспроводной локальной сети получил кадр ответа маяка или пробы. Этот элемент является числом 100-наносекундных интервалов с 1 января 1601 года.

Дополнительные сведения см. в описании функции NdisGetCurrentSystemTime , описанной в WDK.

usCapabilityInformation

Значение поля Сведения о возможности из кадра 802.11 Beacon или Probe Response, полученного интерфейсом беспроводной локальной сети. Это значение представляет собой набор битовых флагов, определяющих возможность.

Этот элемент может иметь одно или несколько из следующих значений.

ulChCenterFrequency

Центральная частота канала диапазона, на котором был получен кадр маяка или отклика зонда 802.11. Значение ulChCenterFrequency находится в единицах килогерц (кГц).

wlanRateSet

Набор скоростей передачи данных, поддерживаемых службой BSS. Тип данных для этого элемента является WLAN_RATE_SET структурой.

ulIeOffset

Смещение в байтах большого двоичного объекта данных информационного элемента (IE) от начала структуры WLAN_BSS_ENTRY .

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

Информационные элементы определены в спецификациях IEEE 802.11, чтобы иметь общий общий формат, состоящий из поля идентификатора 1-байтового элемента, поля 1-байтовой длины длины и информационного поля для элементов переменной длины. Каждому информационному элементу присваивается уникальное значение идентификатора элемента, как определено в стандартах IEEE 802.11. Поле Length указывает количество байтов в информационном поле.

ulIeSize

Размер (в байтах) большого двоичного объекта данных IE в структуре WLAN_BSS_ENTRY .

Это точная длина данных в буфере, на который указывает элемент ulIeOffset , и не содержит заполнения для выравнивания. Максимальное значение для размера большого двоичного объекта данных IE — 2324 байта.

Комментарии

Функция WlanGetNetworkBssList извлекает список BSS беспроводной сети или сетей на заданном интерфейсе и возвращает эти сведения в WLAN_BSS_LIST структуре, содержащей массив . WLAN_BSS_ENTRY структуры.

Если интерфейс беспроводной локальной сети также работает как беспроводная размещенная сеть, список BSS будет содержать запись для BSS, созданной для беспроводной сети.

Так как сведения возвращаются точкой доступа для сети BSS инфраструктуры или одноранговым сетевым элементом для независимой сети BSS (нерегламентированной сети), возвращаемые сведения не должны быть доверенными. Члены ulIeOffset и ulIeSize в структуре WLAN_BSS_ENTRY следует использовать для определения максимального размера большого двоичного объекта данных информационного элемента в WLAN_BSS_ENTRY структуре, а не данных в blob-объекте данных информационного элемента.

Требования

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

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList