структура WLAN_PHY_RADIO_STATE (wlanapi.h)

Статья
03/13/2024

Структура WLAN_PHY_RADIO_STATE указывает состояние радиосвязи для определенного типа физического уровня (PHY).

Синтаксис

typedef struct _WLAN_PHY_RADIO_STATE {
  DWORD             dwPhyIndex;
  DOT11_RADIO_STATE dot11SoftwareRadioState;
  DOT11_RADIO_STATE dot11HardwareRadioState;
} WLAN_PHY_RADIO_STATE, *PWLAN_PHY_RADIO_STATE;

Члены

dwPhyIndex

Индекс типа PHY, для которого устанавливается или запрашивается состояние радиосвязи. Функция WlanGetInterfaceCapability возвращает список допустимых типов PHY.

dot11SoftwareRadioState

Значение DOT11_RADIO_STATE , указывающее состояние радио программного обеспечения.

dot11HardwareRadioState

Значение DOT11_RADIO_STATE , указывающее состояние радиосвязи оборудования.

Структура WLAN_PHY_RADIO_STATE также используется для уведомления модуля для конкретного носителя (MSM) при изменении состояния радио. Приложение регистрируется для получения уведомлений MSM путем вызова функции WlanRegisterNotification с параметром dwNotifSource со значением, включающим WLAN_NOTIFICATION_SOURCE_MSM. Дополнительные сведения об этих уведомлениях см . в WLAN_NOTIFICATION_DATA структуре и справочнике по перечислению WLAN_NOTIFICATION_MSM .

Если элемент dot11SoftradioState или dot11HardwareRadioState структуры WLAN_PHY_RADIO_STATE dot11_radio_state_off, переключатель PHY отключен.

Состояние аппаратного радиосвязи невозможно изменить путем вызова функции WlanSetInterface . Элемент dot11HardwareRadioState структуры WLAN_PHY_RADIO_STATE игнорируется при вызове функции WlanSetInterface с параметром OpCode , равным wlan_intf_opcode_radio_state , а параметр pData указывает на структуру WLAN_PHY_RADIO_STATE .

Состояние программного радиосвязи можно изменить, вызвав функцию WlanSetInterface .

Изменение состояния программного радиосвязи физического сетевого интерфейса может привести к соответствующим изменениям состояния беспроводной сети или состояния радиомодулов виртуального беспроводного адаптера. Узлы PHY каждого виртуального беспроводного адаптера связаны. Дополнительные сведения см. в разделе Сведения о беспроводной размещенной сети.

Состояние радиосвязи PHY выключено, если состояние программного радио (элемент dot11SoftwareRadioState ) или состояние радиосвязи оборудования (элемент dot11HardwareRadioState ) выключено.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	wlanapi.h