structure WLAN_PHY_RADIO_STATE (wlanapi.h)

Article
03/13/2024

La structure WLAN_PHY_RADIO_STATE spécifie l’état radio sur un type de couche physique (PHY) spécifique.

Syntaxe

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

Membres

dwPhyIndex

Index du type PHY sur lequel l’état radio est défini ou interrogé. La fonction WlanGetInterfaceCapability retourne une liste de types PHY valides.

dot11SoftwareRadioState

Valeur DOT11_RADIO_STATE qui indique l’état radio du logiciel.

dot11HardwareRadioState

Valeur DOT11_RADIO_STATE qui indique l’état radio du matériel.

Remarques

La structure WLAN_PHY_RADIO_STATE est utilisée avec la fonction WlanSetInterface lorsque le paramètre OpCode est défini sur wlan_intf_opcode_radio_state.

La structure WLAN_PHY_RADIO_STATE est également utilisée pour la notification par le module msm (media specific module) lorsque l’état de la radio change. Une application s’inscrit pour recevoir des notifications MSM en appelant la fonction WlanRegisterNotification avec le paramètre dwNotifSource défini sur une valeur qui inclut WLAN_NOTIFICATION_SOURCE_MSM. Pour plus d’informations sur ces notifications, consultez la structure WLAN_NOTIFICATION_DATA et les informations de référence sur l’énumération WLAN_NOTIFICATION_MSM .

L’état radio d’un PHY est désactivé si le membre dot11SoftwareRadioState ou dot11HardwareRadioState de la structure WLAN_PHY_RADIO_STATE est dot11_radio_state_off.

L’état de la radio matérielle ne peut pas être modifié en appelant la fonction WlanSetInterface . Le membre dot11HardwareRadioState de la structure WLAN_PHY_RADIO_STATE est ignoré lorsque la fonction WlanSetInterface est appelée avec le paramètre OpCode défini sur wlan_intf_opcode_radio_state et que le paramètre pData pointe vers une structure WLAN_PHY_RADIO_STATE .

L’état de la radio logicielle peut être modifié en appelant la fonction WlanSetInterface .

La modification de l’état de la radio logicielle d’une interface réseau physique peut entraîner des modifications connexes dans l’état des états radio du réseau hébergé sans fil ou de l’adaptateur sans fil virtuel. Les PHY de chaque carte sans fil virtuelle sont liées. Pour plus d’informations, consultez À propos du réseau hébergé sans fil.

L’état radio d’un PHY est désactivé si l’état radio du logiciel (membre dot11SoftwareRadioState ) ou l’état radio matériel (membre dot11HardwareRadioState ) est désactivé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	wlanapi.h