структура DOT11_BSS_ENTRY (windot11.h)
Синтаксис
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) |