struktur WLAN_PHY_RADIO_STATE (wlanapi.h)

Artikel
03/15/2023

Struktur WLAN_PHY_RADIO_STATE menentukan status radio pada jenis lapisan fisik (PHY) tertentu.

Sintaks

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

Anggota

dwPhyIndex

Indeks jenis PHY tempat status radio sedang diatur atau dikueri. Fungsi WlanGetInterfaceCapability mengembalikan daftar jenis PHY yang valid.

dot11SoftwareRadioState

Nilai DOT11_RADIO_STATE yang menunjukkan status radio perangkat lunak.

dot11HardwareRadioState

Nilai DOT11_RADIO_STATE yang menunjukkan status radio perangkat keras.

Keterangan

Struktur WLAN_PHY_RADIO_STATE digunakan dengan fungsi WlanSetInterface saat parameter OpCode diatur ke wlan_intf_opcode_radio_state.

Struktur WLAN_PHY_RADIO_STATE juga digunakan untuk pemberitahuan oleh modul khusus media (MSM) ketika status radio berubah. Aplikasi mendaftar untuk menerima pemberitahuan MSM dengan memanggil fungsi WlanRegisterNotification dengan parameter dwNotifSource yang diatur ke nilai yang menyertakan WLAN_NOTIFICATION_SOURCE_MSM. Untuk informasi selengkapnya tentang pemberitahuan ini, lihat struktur WLAN_NOTIFICATION_DATA dan referensi enumerasi WLAN_NOTIFICATION_MSM .

Status radio PHY nonaktif jika dot11SoftwareRadioState atau dot11HardwareRadioState anggota struktur WLAN_PHY_RADIO_STATEdot11_radio_state_off.

Status radio perangkat keras tidak dapat diubah dengan memanggil fungsi WlanSetInterface . Anggota dot11HardwareRadioState dari struktur WLAN_PHY_RADIO_STATE diabaikan ketika fungsi WlanSetInterface dipanggil dengan parameter OpCode yang diatur ke wlan_intf_opcode_radio_state dan parameter pData menunjuk ke struktur WLAN_PHY_RADIO_STATE .

Status radio perangkat lunak dapat diubah dengan memanggil fungsi WlanSetInterface .

Mengubah status radio perangkat lunak antarmuka jaringan fisik dapat menyebabkan perubahan terkait dalam status Jaringan Yang Dihosting nirkabel atau status radio adaptor nirkabel virtual. PHY dari setiap adaptor nirkabel virtual ditautkan. Untuk informasi selengkapnya, lihat Tentang Jaringan yang Dihosting Nirkabel.

Status radio PHY nonaktif jika status radio perangkat lunak (anggota dot11SoftwareRadioState ) atau status radio perangkat keras (anggota dot11HardwareRadioState ) nonaktif.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	wlanapi.h