Panduan Desain Driver WDI Miniport

Penting

WiFiCx adalah model driver Wi-Fi baru yang dirilis di Windows 11. Kami menyarankan agar Anda menggunakan WiFiCx untuk memanfaatkan fitur terbaru. Model driver WDI sekarang dalam mode pemeliharaan dan hanya akan menerima perbaikan prioritas tinggi.

WLAN Device Driver Interface (WDI) adalah model driver Universal Windows baru untuk driver Wi-Fi, untuk Windows 10 untuk edisi desktop (Home, Pro, Enterprise, dan Education) dan Windows 10 Mobile. Produsen perangkat WLAN menulis driver miniport WDI untuk bekerja dengan implementasi OS Windows 10. WDI memungkinkan produsen perangkat untuk menulis lebih sedikit kode daripada model driver WLAN Asli sebelumnya. Semua fitur WLAN baru yang diperkenalkan di Windows 10 memerlukan driver berbasis WDI.

Driver WLAN asli yang disediakan vendor terus bekerja di Windows 10, tetapi fungsionalitas terbatas pada versi Windows yang dikembangkan.

Persyaratan WDI dan spesifikasi antarmuka didokumenkan dalam panduan desain ini. Tujuan utama untuk model baru adalah:

  • Meningkatkan kualitas dan keandalan driver Windows WLAN.
  • Mengurangi kompleksitas model driver saat ini, yang pada gilirannya mengurangi kompleksitas driver IHV dan mengurangi biaya keseluruhan pengembangan driver IHV.

Fokus dari dokumentasi ini adalah untuk menentukan alur dan perilaku operasi Wi-Fi antara Windows dan komponen driver IHV. Ini tidak mencakup tanda tangan antarmuka perangkat lunak (misalnya, model antarmuka driver perangkat) dan detail tentang bagaimana komponen IHV dimuat di Windows.

Prinsip desain

Prinsip-prinsip berikut memandu model dan desain keseluruhan protokol ini.

  1. Minimalkan obrolan lalu lintas antara komponen host dan komponen/perangkat IHV. Ini sangat penting untuk implementasi pada bus seperti SDIO, yang secara inheren cerewet.
  2. Wi-Fi fungsionalitas (terutama fungsionalitas yang harus dilakukan dengan latensi rendah) diharapkan ditangani oleh perangkat.
  3. Semua fungsionalitas terkait peraturan berada di komponen IHV dan dikendalikan oleh IHV.
  4. Pengalaman Windows dikendalikan oleh komponen host dan sistem operasi Windows.
  5. Windows memiliki kemampuan untuk mebangkitkan kembali perangkat yang digantung. Ini memiliki status yang cukup untuk memprogram ulang komponen IHV dan memulihkan dalam waktu 10 detik.
  6. Operasi yang membutuhkan banyak memori sistem atau prosesor cepat dan tidak spesifik vendor ditangani oleh host.

Definisi

Istilah Deskripsi

Perangkat

Seluruh perangkat keras yang terhubung ke bus. Perangkat dapat memiliki beberapa radio di dalamnya (terutama Wi-Fi dan Bluetooth).

adaptor Wi-Fi

Bagian spesifik dari perangkat yang mengimplementasikan fungsionalitas Wi-Fi seperti yang dijelaskan dalam spesifikasi ini.

Port

Objek yang mewakili status MAC dan PHY untuk koneksi tertentu.

Komponen IHV

Komponen perangkat lunak yang dikembangkan IHV yang mewakili Wi-Fi Adapter/Perangkat ke host.

Host

Perangkat lunak Microsoft/sistem operasi sisi host yang berinteraksi dengan komponen IHV menggunakan antarmuka yang dijelaskan dalam spesifikasi ini.

Driver Tepi Atas (UE)

UE mengacu pada driver WdiWiFi, yang disebut WDI dalam dokumentasi ini. Driver IHV UE dan Lower Edge (LE) digabungkan menjadi driver miniport NDIS lengkap. UE mengimplementasikan logika Wi-Fi inti.

Driver Tepi Bawah (LE)

LE mengacu pada driver IHV di tepi bawah. LE dan UE digabungkan menjadi driver miniport NDIS lengkap. LE mengimplementasikan fungsi khusus bus dan perangkat keras.

Reset Tingkat Fungsi (FLR)

Reset Tingkat Fungsi, seperti dalam spesifikasi PCIe. Istilah ini mengacu pada reset fungsi, versus reset perangkat lengkap yang mungkin memiliki fungsi komposit. Reset cakupan tersebut tidak mengganggu fungsi lain pada perangkat yang sama.

Reset Tingkat Platform (PLR)

Reset Tingkat Platform. Metode reset ini berdampak pada semua fungsi pada perangkat. Sangat populer untuk membangun beberapa fungsi pada perangkat untuk mengurangi biaya dan jejak. Misalnya, Bluetooth biasanya dibangun dengan Wi-Fi pada chip. Namun, metode reset seperti itu mengatur ulang semua unit fungsi pada perangkat.

Reset Pemulihan (RR)

RR mengacu pada urutan peristiwa Reset dan Pemulihan.

Untuk FLR, ini termasuk:

  • Permintaan ke NDIS, yang meneruskan permintaan ke bus untuk mengatur ulang fungsi Wi-Fi.
  • Pemulihan konteks firmware oleh driver.
  • Sambungkan kembali ke titik akses jika tersambung sebelum reset.

Untuk PLR, ini termasuk:

  • Permintaan ke NDIS, yang meneruskan permintaan ke bus. Bus berinteraksi dengan PnP untuk meniadakan perangkat.
  • Enumerasi ulang perangkat.
  • Membuat ulang tumpukan perangkat.
  • Wi-Fi dimulai ulang dan tersambung kembali.

Perintah WDI

UE mengirimkan OID WDI dan memanggil panggilan balik LE. Semua ini disebut perintah WDI.

Pengacakan Alamat MAC

Untuk meningkatkan privasi pengguna Windows 10, alamat MAC Wi-Fi yang dikonfigurasi digunakan dalam beberapa keadaan, seperti sebelum terhubung ke jaringan Wi-Fi tertentu atau saat memulai pemindaian dalam kondisi tertentu. Ini hanya berlaku untuk port stasiun. Sistem memastikan bahwa pengacakan digunakan dengan tepat, sehingga skenario konektivitas penting tidak rusak. Sistem mengelola perubahan alamat dengan mengeluarkan perintah OID_WDI_TASK_DOT11_RESET sebelum mengeluarkan perintah pemindaian atau koneksi. Parameter perintah reset menyertakan argumen alamat MAC opsional. Jika argumen ada, alamat MAC diatur ulang ke nilai yang ditentukan. Jika tidak ada, alamat MAC dibiarkan ke nilai saat ini. Saat mengonfigurasi alamat MAC acak, sistem operasi menggunakan format "dikelola secara lokal" yang ditentukan untuk alamat IEEE802.

ECSA

Pengumuman Pengalihan Saluran yang Diperluas.

Referensi Driver WDI Miniport