Fungsi WifiDeviceSetStationCapabilities (wificx.h)

Fungsi WifiDeviceSetStationCapabilities mengatur kemampuan stasiun untuk perangkat WiFiCx.

Sintaks

NTSTATUS WifiDeviceSetStationCapabilities(
  WDFDEVICE                       Device,
  const WIFI_STATION_CAPABILITIES *StationCapabilities
);

Parameter

Device

Handel ke objek perangkat kerangka kerja yang diperoleh driver klien dari panggilan sebelumnya ke WdfDeviceCreate.

StationCapabilities

Penunjuk ke struktur WIFI_STATION_CAPABILITIES yang dialokasikan dan dialokasikan driver klien.

Menampilkan nilai

Mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi ini dapat mengembalikan kode kesalahan NTSTATUS yang sesuai.

Keterangan

Driver klien biasanya memanggil WifiDeviceSetStationCapabilities dalam EvtDevicePrepareHardware. Untuk informasi selengkapnya lihat Alur pembuatan adaptor default (stasiun).

Panggil WIFI_STATION_CAPABILITIES_INIT untuk menginisialisasi struktur WIFI_STATION_CAPABILITIES dan mengisi bidang Ukurannya . Kemudian panggil WifiDeviceSetStationCapabilities untuk melaporkan kemampuan stasiun ke WiFiCx.

Untuk menunjukkan kemampuan untuk mempertahankan konektivitas Sta Sekunder, driver harus mengatur bidang NumSecondaryStaBandCombinations dan SecondaryStaBandsCombinations dari struktur WIFI_STATION_CAPABILITIES ke nilai non-nol. Jika salah satu nilai adalah 0 atau NULL, maka kemampuan Stay Sekunder tidak akan diatur.

Untuk menunjukkan dukungan untuk koneksi MLO di Wi-Fi 7, driver harus mengatur bidang MaxMLOLinksSupported, MLOAddressesList, NumAkmsSupported, dan AkmsList dari struktur WIFI_STATION_CAPABILITIES ke nilai non-nol.

Untuk mendukung koneksi SAE menggunakan AKM 24 atau AKM 8 dengan cipher GCMP-256, driver harus menambahkan pasangan auth-cipher berikut dalam struktur WIFI_STATION_CAPABILITIES :

• Di UnicastAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
• Di MulticastMgmtAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }

Untuk mendukung koneksi OWE dengan cipher GCMP-256, driver harus menambahkan pasangan auth-cipher berikut:

• Di UnicastAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11
Server minimum yang didukung	Windows Server 2022
Header	wificx.h
IRQL	PASSIVE_LEVEL

Lihat juga

WIFI_STATION_CAPABILITIES

WIFI_STATION_CAPABILITIES_INIT

Alur pembuatan adaptor default (stasiun)