структура WLAN_PHY_RADIO_STATE (wlanapi.h)
Структура 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 используется с функцией WlanSetInterface , если для параметра OpCode задано значение wlan_intf_opcode_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 |