WLAN_PHY_RADIO_STATE 結構 (wlanapi.h)

發行項
03/04/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 函式，並將 dwNotifSource 參數設定為包含WLAN_NOTIFICATION_SOURCE_MSM的值來註冊以接收 MSM 通知。如需這些通知的詳細資訊，請參閱 WLAN_NOTIFICATION_DATA 結構和 WLAN_NOTIFICATION_MSM 列舉參考。

如果 WLAN_PHY_RADIO_STATE 結構的dot11SoftwareRadioState 或 dot11HardwareRadioState 成員dot11_radio_state_off，PHY 的無線電狀態就會關閉。

無法藉由呼叫 WlanSetInterface 函式來變更硬體無線電狀態。當呼叫 WlanSetInterface 函式時，會忽略 WLAN_PHY_RADIO_STATE 結構的 dot11HardwareRadioState 成員，並將 OpCode 參數設定為 wlan_intf_opcode_radio_state，而 pData 參數會指向 WLAN_PHY_RADIO_STATE 結構。

呼叫 WlanSetInterface 函式即可變更軟體無線電狀態。

變更實體網路介面的軟體無線電狀態可能會導致無線託管網路狀態或虛擬無線適配卡無線電狀態的相關變更。每個虛擬無線適配卡的 PHY 都會連結。如需詳細資訊，請參閱關於無線託管網路。

如果軟體無線電狀態 (dot11SoftwareRadioState 成員) 或硬體無線電狀態 (dot11HardwareRadioState 成員關閉) ，PHY 的無線電狀態就會關閉。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	wlanapi.h