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 値。

注釈

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