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

Структура DOT11_SCAN_REQUEST_V2 определяет параметры для явной операции сканирования, выполняемой станцией 802.11. Станция выполняет явную операцию сканирования после запроса на набор OID OID_DOT11_SCAN_REQUEST.

Синтаксис

typedef struct _DOT11_SCAN_REQUEST_V2 {
  DOT11_BSS_TYPE    dot11BSSType;
  DOT11_MAC_ADDRESS dot11BSSID;
  DOT11_SCAN_TYPE   dot11ScanType;
  BOOLEAN           bRestrictedScan;
  ULONG             udot11SSIDsOffset;
  ULONG             uNumOfdot11SSIDs;
  BOOLEAN           bUseRequestIE;
  ULONG             uRequestIDsOffset;
  ULONG             uNumOfRequestIDs;
  ULONG             uPhyTypeInfosOffset;
  ULONG             uNumOfPhyTypeInfos;
  ULONG             uIEsOffset;
  ULONG             uIEsLength;
  UCHAR             ucBuffer[1];
} DOT11_SCAN_REQUEST_V2, *PDOT11_SCAN_REQUEST_V2;

Члены

dot11BSSType

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

dot11BSSID

Идентификатор BSS (BSSID) сети BSS, для которой проверяется станция 802.11. Если для этого элемента задан подстановочный знак BSSID (0xFFFFFFFFFFFF), станция проверяет все BSSID.

dot11ScanType

Тип сканирования, выполняемого станцией 802.11. Типом данных для этого элемента является перечисление DOT11_SCAN_TYPE, которое объявляет следующие значения:

dot11_scan_type_active

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

dot11_scan_type_passive

Станция не передает кадр запроса пробы 802.11 на каждом сканируемом канале. Вместо этого он получает кадры маяка 802.11 или запроса пробы, отправленные в канале.

dot11_scan_type_auto

Станция может выполнять активные или пассивные проверки или использовать сочетание обоих типов сканирования.

Независимо от значения dot11ScanType, станция 802.11 должна выполнять проверку типа dot11_scan_type_passive при каждом сканировании каналов, которые не являются допустимыми в текущем нормативном домене. Кроме того, станция 802.11 должна выполнять проверку типа dot11_scan_type_passive , если у нее нет нормативного домена по умолчанию. Дополнительные сведения о нормативных доменах см . в разделе OID_DOT11_CURRENT_REG_DOMAIN.

Если бит dot11_scan_type_forced задан в элементе dot11ScanType , станция 802.11 должна выполнить полную проверку для каждого поддерживаемого канала. Если бит dot11_scan_type_forced не задан, станция 802.11 может выполнить полное сканирование или частичное сканирование в подмножестве поддерживаемых каналов.

bRestrictedScan

Если этот элемент имеет значение TRUE, то станция 802.11 выполняет сканирование, ограниченное каналом и конфигурацией PHY, используемой для подключения к сети BSS.

Драйвер мини-порта должен игнорировать этот элемент, если выполняется одно из следующих действий:

• Драйвер мини-порта работает в режиме ExtSTA.
• Станция 802.11 не подключена к сети BSS.

udot11SSIDsOffset

Смещение в массиве ucBuffer , где начинается список идентификаторов набора служб (SSID). Каждая запись в списке SSID имеет формат структуры DOT11_SSID .

Станция 802.11 проверяет каждый идентификатор SSID в списке. Например, если параметру dot11ScanType присвоено значение dot11_scan_type_active, при сканировании канала станция 802.11 передает запрос пробы 802.11 для каждого идентификатора SSID в списке.

uNumOfdot11SSIDs

Количество записей в списке SSID.

Если uNumOfdot11SSIDs равно нулю, драйвер мини-порта должен использовать список SSID, содержащий подстановочный знак нулевой длины SSID.

bUseRequestIE

Если этот элемент имеет значение TRUE, то станция 802.11 должна включать список идентификаторов запросов (определенных с помощью элементов uRequestIDsOffset и uNumOfRequestIDs ) в элементе сведений о запросе 802.11d каждого кадра запроса пробы, передаваемого во время активной проверки.

Драйвер мини-порта должен игнорировать этот элемент (вместе с элементами uRequestIDsOffset и uNumOfRequestIDs ), если выполняется одно из следующих значений:

• Драйвер мини-порта работает в режиме ExtSTA.
• Объект 802.11 dot1MultiDomainCapabilityEnabled management information base (MIB) имеет значение FALSE. Дополнительные сведения об объекте MIB dot11MultiDomainCapabilityEnabled см. в статье. OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
• Член dot11ScanType имеет значение dot11_scan_type_passive.

uRequestIDsOffset

Смещение в массиве ucBuffer , с которого начинается список идентификаторов запросов. Каждая запись в списке идентификаторов запросов форматируется как тип данных UCHAR.

uNumOfRequestIDs

Количество записей в списке идентификаторов запросов.

uPhyTypeInfosOffset

Смещение в массиве ucBuffer , с которого начинается список типов PHY. Каждая запись в списке типов PHY форматируется как DOT11_PHY_TYPE_INFO структура.

Станция 802.11 должна выполнять проверку BSS, используя каждый из указанных типов PHY из этого списка.

Драйвер мини-порта должен игнорировать этот элемент (вместе с элементом uNumOfPhyTypeInfos ), если bRestrictedScan имеет значение TRUE.

uNumOfPhyTypeInfos

Количество записей в списке типов PHY.

Если параметр uNumOfPhyTypeInfos равен нулю, то станция 802.11 выполняет сканирование, используя все поддерживаемые функции PHY.

uIEsOffset

Смещение в массиве ucBuffer , с которого начинается список информационных элементов переменной длины . Станция 802.11 должна добавлять список IEs в конец каждого кадра запроса пробы, передаваемого во время активной проверки.

Драйвер мини-порта должен игнорировать этот элемент (вместе с элементом uIEsLength ), если параметру dot11ScanType присвоено значение dot11_scan_type_passive.

uIEsLength

Длина (в байтах) списка IES.

ucBuffer[1]

Буфер, содержащий необязательные данные, указанные через другие члены этой структуры.

Комментарии

Станция 802.11 выполняет явные операции сканирования после запроса набора OID OID_DOT11_SCAN_REQUEST. Станция выполняет операцию сканирования с помощью параметров, определенных с помощью DOT11_SCAN_REQUEST_V2, которая сопровождает запрос набора.

Дополнительные сведения об операциях сканирования, выполняемых собственным драйвером мини-порта 802.11, см. в статье Собственные операции сканирования 802.11.

Дополнительные сведения о режиме работы ExtSTA см. в разделе Режим работы расширяемой станции.

Требования

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

DOT11_PHY_TYPE_INFO

OID_DOT11_SCAN_REQUEST