WLAN_PHY_RADIO_STATE Struktur (wlanapi.h)

Die WLAN_PHY_RADIO_STATE-Struktur gibt den Funkzustand für einen bestimmten PHY-Typ (Physical Layer) an.

Syntax

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

Member

dwPhyIndex

Der Index des PHY-Typs, für den der Funkzustand festgelegt oder abgefragt wird. Die WlanGetInterfaceCapability-Funktion gibt eine Liste gültiger PHY-Typen zurück.

dot11SoftwareRadioState

Ein DOT11_RADIO_STATE Wert, der den Softwarefunkzustand angibt.

dot11HardwareRadioState

Ein DOT11_RADIO_STATE Wert, der den Hardwarefunkzustand angibt.

Hinweise

Die WLAN_PHY_RADIO_STATE-Struktur wird mit der WlanSetInterface-Funktion verwendet, wenn der OpCode-Parameter auf wlan_intf_opcode_radio_state festgelegt ist.

Die WLAN_PHY_RADIO_STATE-Struktur wird auch für Benachrichtigungen durch das medienspezifische Modul (MSM) verwendet, wenn sich der Funkzustand ändert. Eine Anwendung registriert sich zum Empfangen von MSM-Benachrichtigungen, indem sie die WlanRegisterNotification-Funktion aufruft, wobei der dwNotifSource-Parameter auf einen Wert festgelegt ist, der WLAN_NOTIFICATION_SOURCE_MSM enthält. Weitere Informationen zu diesen Benachrichtigungen finden Sie in der WLAN_NOTIFICATION_DATA-Struktur und der WLAN_NOTIFICATION_MSM-Enumerationsreferenz.

Der Funkstatus eines PHY ist deaktiviert, wenn entweder dot11SoftwareRadioState oder dot11HardwareRadioState-Member der WLAN_PHY_RADIO_STATE-Strukturdot11_radio_state_off ist.

Der Hardwarefunkzustand kann nicht durch Aufrufen der WlanSetInterface-Funktion geändert werden. Das dot11HardwareRadioState-Element der WLAN_PHY_RADIO_STATE-Struktur wird ignoriert, wenn die WlanSetInterface-Funktion aufgerufen wird, wobei der OpCode-Parameter auf wlan_intf_opcode_radio_state festgelegt ist und der pData-Parameter auf eine WLAN_PHY_RADIO_STATE-Struktur verweist.

Der Softwarefunkzustand kann durch Aufrufen der WlanSetInterface-Funktion geändert werden.

Das Ändern des Softwarefunkzustands einer physischen Netzwerkschnittstelle kann zu entsprechenden Änderungen im Zustand des funkinternen gehosteten Netzwerks oder des virtuellen Drahtlosadapters führen. Die PHYs jedes virtuellen Drahtlosadapters sind verknüpft. Weitere Informationen finden Sie unter Informationen zum gehosteten Drahtlosnetzwerk.

Der Funkstatus eines PHY ist deaktiviert, wenn entweder der Softwarefunkstatus (dot11SoftwareRadioState-Member ) oder der Hardwarefunkzustand (dot11HardwareRadioState-Member ) deaktiviert ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile wlanapi.h

Weitere Informationen

Informationen zum drahtlos gehosteten Netzwerk

DOT11_RADIO_STATE

WLAN_NOTIFICATION_DATA

WLAN_NOTIFICATION_MSM

WLAN_RADIO_STATE

WlanGetInterfaceCapability

WlanSetInterface