структура 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 см. в разделе Режим работы расширяемой станции.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| Верхняя часть | windot11.h (включая Ndis.h) |