Bagikan melalui


OID_WDI_TASK_CONNECT

Penting

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

OID_WDI_TASK_CONNECT meminta komponen IHV tersambung ke Access Point atau ke Wi-Fi Direct GO.

Object 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 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 kandidat entri BSS. Ini dapat menggunakan daftar yang disediakan oleh host untuk menyambungkan. 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 "Sambungkan Penggantian Pilihan BSS", adaptor hanya boleh menggunakan entri yang disediakan oleh host untuk sambungan. 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 "Sambungkan Penggantian Pilihan BSS", adaptor dapat melakukan pemindaian sendiri untuk menemukan entri BSS kandidat. 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 bisa termasuk mengoptimalkan pemindaian jelajah, 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 tidak boleh mengatur ulang pengaturan apa pun yang mungkin telah dikonfigurasi di luar perintah sambungkan. Ini harus mendukung host yang mengeluarkan panggilan koneksi 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 Langsung). Namun, port dapat mengurangi jumlah akses sedang yang disediakan ke port lain untuk menyelesaikan koneksi. Selama koneksi, host dapat mengirimkan permintaan pengiriman paket pada 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 Reassosiasinya.

Jika port menyatakan dukungan untuk mode HOST FIPS di WDI_TLV_STATION_ATTRIBUTES, 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 operasi Kirim dalam mode FIPS dan Menerima operasi dalam mode FIPS.
  • Port tidak boleh mendeklarasikan 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 pengiriman agregasi MSDU.
  • 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) mengharuskan port untuk mengenkripsi/mendekripsi manajemen dan bingkai tindakan tertentu, sehingga tidak dapat diaktifkan untuk koneksi menggunakan mode HOST FIPS. Selain itu, fitur Wake on Wireless LAN tidak berlaku dalam mode Host-FIPS.

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 bit Sambungkan Penggantian Pilihan BSS, maka adaptor 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

Klien minimum yang didukung

Windows 10

Server minimum yang didukung

Server Windows 2016

Header

Dot11wdi.h