Bagikan melalui


OID_WDI_TASK_CONNECT (dot11wificxintf.h)

Penting

Topik ini adalah bagian dari model driver WiFiCx. WiFiCx adalah model driver Wi-Fi yang dirilis di Windows 11. Kami menyarankan agar Anda menggunakan WiFiCx untuk memanfaatkan fitur terbaru. WDI model driver Wi-Fi sebelumnya berada dalam mode pemeliharaan dan hanya akan menerima perbaikan prioritas tinggi.

OID_WDI_TASK_CONNECT meminta komponen IHV terhubung ke Titik Akses atau ke Wi-Fi Direct GO.

Objek Batalkan kemampuan Prioritas default (kebijakan driver host) Waktu eksekusi normal (detik)
Port Ya. Pembatalan harus diikuti oleh reset dot11. 4 10

Sebagai bagian dari koneksi, komponen IHV harus disinkronkan dengan, mengautentikasi ke, dan mengaitkan ke BSS. Host menyediakan entri BSS yang dapat dicoba untuk disambungkan oleh komponen IHV. Setelah komponen IHV berhasil terhubung ke salah satu entri tersebut, komponen tersebut harus menyelesaikan proses koneksi. Jika tidak dapat terhubung ke salah satu entri BSS, itu harus menyelesaikan proses koneksi dengan kegagalan.

Komponen IHV tidak perlu melakukan pemindaian untuk menemukan entri kandidat BSS. Ini dapat menggunakan daftar yang disediakan oleh host untuk koneksi. Ini dapat mencoba untuk terhubung ke masing-masing, satu demi satu. Host mengurutkan jaringan menurut RSSI, tetapi komponen IHV dapat menggunakan urutannya sendiri untuk koneksi. Jika adaptor tidak menentukan "Koneksi BSS Selection Override", adapter hanya boleh menggunakan entri yang disediakan oleh host untuk koneksi. Host dapat mengeluarkan pembatalakuan pada koneksi yang luar biasa. Saat menerima pembatalan, port harus mengakhiri upaya koneksi dan melaporkan penyelesaian ke host.

Jika adaptor menentukan "Koneksi BSS Selection Override", adaptor dapat melakukan pemindaian sendiri untuk menemukan kandidat entri BSS. Ini dapat terhubung ke entri BSS yang ditemukannya selama memenuhi parameter yang dikonfigurasi oleh host. Ini harus mengoptimalkan pilihan ini untuk memastikan bahwa ia memenuhi persyaratan kualitas koneksi yang dikonfigurasi. Ini dapat mencakup mengoptimalkan pemindaian roam, mengoptimalkan pemilihan AP, mengoptimalkan proses asosiasi, dan meminimalkan jabat tangan keamanan yang diperlukan. Selama pemindaian, jika perangkat memerlukan parameter asosiasi tambahan untuk entri BSS yang ditemukan (misalnya, PMKID untuk roaming), perangkat dapat mengirim indikasi NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST untuk mendapatkan parameter. Jika tersedia, host mengonfigurasi parameter ini dengan OID_WDI_SET_ASSOCIATION_PARAMETERS.

Jika koneksi gagal atau dibatalkan, port seharusnya tidak mengatur ulang pengaturan apa pun yang mungkin telah dikonfigurasi di luar perintah sambungkan. Ini harus mendukung host yang mengeluarkan panggilan sambungan kedua pada port yang sama.

Status upaya sambungkan untuk setiap entri BSS harus dilaporkan oleh port di akhir upaya asosiasi. Ini termasuk upaya yang berhasil dan juga upaya yang gagal. Kapan saja, port harus dikaitkan dengan tidak lebih dari satu Titik Akses atau Wi-Fi Direct GO.

Saat koneksi sedang berlangsung, port harus mempertahankan koneksi apa pun yang dibuat pada port lain (misalnya, Infrastruktur atau Wi-Fi Direct). Namun, port dapat mengurangi jumlah akses sedang yang disediakan ke port lain untuk menyelesaikan koneksi. Selama koneksi, host dapat mengirimkan permintaan pengiriman paket di port lain.

Jika algoritma autentikasi yang digunakan untuk koneksi memerlukan otorisasi port 802.1x untuk akses jaringan, host mengotorisasi port setelah operasi asosiasi berhasil diselesaikan.

Stasiun 802.11 menggunakan cache PMKID untuk pra-autentikasi untuk mengakses titik yang telah mengaktifkan algoritma autentikasi Asosiasi Jaringan Keamanan Kuat (RSNA). Jika stasiun 802.11 mengaitkan atau mengaitkan kembali dengan BSSID yang memiliki PMKID yang disediakan, stasiun 802.11 harus menggunakan data PMKID dalam elemen informasi RSN (RSN IE) dari asosiasi atau bingkai Reasosiasinya.

Jika port mendeklarasikan dukungan untuk mode HOST FIPS dalam WIFI_STATION_CAPABILITIES, HostFIPSModeEnabled dapat diatur ke 1 dalam parameter koneksi.

Jika HostFIPSModeEnabled diatur ke 1, aturan berikut berlaku.

  • Port harus mengikuti panduan untuk mengirim/menerima bingkai data dalam mengirim operasi dalam mode FIPS dan Menerima operasi dalam mode FIPS.
  • Port tidak boleh menyatakan dukungan untuk protokol QoS apa pun dalam permintaan asosiasi yang dikirim ke titik akses non-HT. Dukungan QoS diperlukan untuk koneksi HT.
  • Port tidak boleh menegosiasikan TSpec dan tidak boleh melakukan agregasi MSDU transmisi.
  • Port harus memastikan bahwa bit berkemampuan SPP A-MSDU (bit 10) dari kemampuan RSN IE yang ditransmisikannya diatur ke nol. Hanya PP A-MSDU yang didukung dalam mode ini.

Parameter koneksi tidak boleh memiliki MFPEnabled dan HostFIPSModeEnabled keduanya diatur ke 1. Perlindungan Bingkai Manajemen (802.11w) memerlukan port untuk mengenkripsi/mendekripsi manajemen dan bingkai tindakan tertentu, sehingga tidak dapat diaktifkan untuk koneksi menggunakan mode FIPS Host. Selain itu, fitur Wake on Wireless LAN tidak berlaku dalam mode Host-FIPS.

Persyaratan WiFi 7 / MLO

Windows menyediakan pengaturan Mlo Koneksi ionSupported di WDI_TLV_CONNECTION_SETTINGS yang menunjukkan apakah driver dapat tersambung menggunakan MLO. Ketika koneksi ke jaringan aman, driver hanya dapat menggunakan pasangan AKM dan cipher yang ditentukan dalam WDI_TLV_RSNA_AKM_CIPHER_SUITE. Satu-satunya pengecualian adalah jika auth/cipher bukan bagian dari RSNA IE.

Untuk informasi selengkapnya, lihat Persyaratan fitur WiFiCx Wi-Fi 7.

Parameter tugas

TLV Beberapa instans TLV diizinkan Opsional Deskripsi
WDI_TLV_CONNECT_PARAMETERS Parameter koneksi.
WDI_TLV_CONNECT_BSS_ENTRY X Daftar entri BSS koneksi kandidat yang disukai. Port harus mencoba menyambungkan ke salah satu entri BSS ini sampai daftar habis atau koneksi berhasil diselesaikan. Port dapat memprioritaskan ulang entri jika diperlukan. Jika adaptor telah mengatur Koneksi BSS Selection Override bit, maka dapat memilih BSS yang tidak ada dalam daftar ini selama mengikuti daftar Diizinkan/Tidak Diizinkan.

Indikasi penyelesaian tugas

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Indikasi yang tidak diminta

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 11
Server minimum yang didukung Windows Server 2022
Header dot11wificxintf.h