wlanapi.h) (WLAN_PHY_RADIO_STATE 结构

项目
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 值。

注解

当 OpCode参数设置为wlan_intf_opcode_radio_state 时，WLAN_PHY_RADIO_STATE 结构与 WlanSetInterface 函数一起使用。

当无线电状态发生更改时， WLAN_PHY_RADIO_STATE结构还用于媒体特定模块 (MSM) 的通知。应用程序通过调用 WlanRegisterNotification 函数来注册以接收 MSM 通知，并将 dwNotifSource 参数设置为包含 WLAN_NOTIFICATION_SOURCE_MSM的值。有关这些通知的详细信息，请参阅 WLAN_NOTIFICATION_DATA 结构和 WLAN_NOTIFICATION_MSM 枚举参考。

如果dot11_radio_state_off WLAN_PHY_RADIO_STATE结构的 dot11SoftwareRadioState 或 dot11HardwareRadioState 成员，则 PHY 的无线电 状态处于关闭状态。

无法通过调用 WlanSetInterface 函数更改硬件无线电状态。当调用 WlanSetInterface 函数并将 OpCode参数设置为 wlan_intf_opcode_radio_state 且 pData 参数指向 WLAN_PHY_RADIO_STATE 结构时，将忽略 WLAN_PHY_RADIO_STATE 结构的 dot11HardwareRadioState 成员。

可以通过调用 WlanSetInterface 函数更改软件无线电状态。

更改物理网络接口的软件无线电状态可能会导致无线托管网络或虚拟无线适配器无线电状态的相关更改。每个虚拟无线适配器的 PHY 都是链接的。有关详细信息，请参阅关于无线托管网络。

如果软件无线电状态 (dot11SoftwareRadioState 成员) 或硬件无线电状态 (dot11HardwareRadioState 成员) 关闭，则 PHY 的无线电状态为 off。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	wlanapi.h