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構造体は、OpCode パラメーターが wlan_intf_opcode_radio_state に設定されている場合に WlanSetInterface 関数と共に使用されます。
WLAN_PHY_RADIO_STATE構造は、無線の状態が変化したときにメディア固有モジュール (MSM) による通知にも使用されます。 アプリケーションは、dwNotifSource パラメーターをWLAN_NOTIFICATION_SOURCE_MSMを含む値に設定された WlanRegisterNotification 関数を呼び出して、MSM 通知を受信するように登録します。 これらの通知の詳細については、 WLAN_NOTIFICATION_DATA 構造体と WLAN_NOTIFICATION_MSM 列挙リファレンスを参照してください。
WLAN_PHY_RADIO_STATE構造体の dot11SoftwareRadioState メンバーまたは dot11HardwareRadioState メンバーがdot11_radio_state_off場合、PHY の無線状態はオフになります。
WlanSetInterface 関数を呼び出して、ハードウェア無線の状態を変更することはできません。 WLAN_PHY_RADIO_STATE 構造体の dot11HardwareRadioState メンバーは、OpCode パラメーターを wlan_intf_opcode_radio_state に設定して WlanSetInterface 関数が呼び出され、pData パラメーターがWLAN_PHY_RADIO_STATE構造体を指している場合は無視されます。
ソフトウェア無線の状態は 、WlanSetInterface 関数を呼び出すことによって変更できます。
物理ネットワーク インターフェイスのソフトウェア無線状態を変更すると、ワイヤレス ホスト型ネットワークまたは仮想ワイヤレス アダプターの無線状態に関連する変更が発生する可能性があります。 すべての仮想ワイヤレス アダプターの PHY がリンクされます。 詳細については、「 ワイヤレス ホステッド ネットワークについて」を参照してください。
ソフトウェア無線状態 (dot11SoftwareRadioState メンバー) またはハードウェア無線状態 (dot11HardwareRadioState メンバー) のいずれかがオフの場合、PHY の無線状態はオフになります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | wlanapi.h |