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

  • Статья
ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте интерфейс WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.

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

Синтаксис

typedef struct _DOT11_PHY_TYPE_INFO {
  union {
    DOT11_PHY_TYPE dot11PhyType;
    ULONG          uPhyId;
  };
  BOOLEAN             bUseParameters;
  ULONG               uProbeDelay;
  ULONG               uMinChannelTime;
  ULONG               uMaxChannelTime;
  CH_DESCRIPTION_TYPE ChDescriptionType;
  ULONG               uChannelListSize;
  UCHAR               ucChannelListBuffer[1];
} DOT11_PHY_TYPE_INFO, *PDOT11_PHY_TYPE_INFO;

Члены

dot11PhyType

Тип PHY, который станция 802.11 будет использовать для сканирования. Тип PHY определяется перечислением DOT11_PHY_TYPE .

Примечание Драйвер мини-порта должен игнорировать этот элемент, если он работает в режиме ExtSTA.

bUseParameters

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

Если этот элемент имеет значение FALSE, станция 802.11 настраивает PHY, используя собственные параметры для операции сканирования.

Примечание Если драйвер мини-порта работает в режиме ExtSTA, операционная система всегда устанавливает для этого элемента значение FALSE.

uProbeDelay

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

uMinChannelTime

Минимальное количество времени (в единицах времени 802,11), которое станция 802.11 тратит на каждый канал при сканировании. Один TU — 1024 микросекунд.

Этот элемент должен быть больше или равен uProbeDelay .

uMaxChannelTime

Максимальное количество времени (в единицах времени 802,11), которое станция 802.11 тратит на каждый канал при сканировании.

Этот элемент должен быть больше или равен uProbeDelay .

ChDescriptionType

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

ch_description_type_logical

Запись канала определяется логическим номером канала в соответствии со стандартом IEEE 802.11.

ch_description_type_center_frequency

Запись канала определяется в единицах мегагерц (МГц) по центральной частоте канала.

uChannelListSize

Длина массива ucChannelListBuffer в байтах. Каждая запись в этом массиве отформатирована как тип данных ULONG.

ucChannelListBuffer[1]

Массив, содержащий описания каналов для типа PHY, указанного в элементе dot11PhyType .

Комментарии

Структура DOT11_SCAN_REQUEST_V2 , которая сопровождает запрос набора OID_DOT11_SCAN_REQUEST, содержит массив из нуля или более DOT11_PHY_TYPE_INFO записей.

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

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть windot11.h (включая Ndis.h)

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

DOT11_SCAN_REQUEST_V2

OID_DOT11_SCAN_REQUEST