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

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте интерфейс драйвера устройств WLAN (WDI). Дополнительные сведения о WDI см. в статье WLAN Universal Windows Driver Model.
 
Структура 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 — это индекс в списке поддерживаемых PHYs, возвращаемых драйвером с помощью запроса OID_DOT11_SUPPORTED_PHY_TYPES.

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

PhySpecificInfo

Атрибуты PHY, на которые ссылается элемент uPhyId . PhySpecificInfo форматируется как a 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.

    Дополнительные сведения о стране 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 из последнего полученного кадра маяка или пробы ответа.

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

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

Remarks

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

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

Требования

   
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Заголовок 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

NdisGetCurrentSystemTime

OID_DOT11_ENUM_BSS_LIST