WDI Miniport Sürücü Tasarım Kılavuzu

Önemli

WiFiCx , Windows 11'de yayınlanan yeni Wi-Fi sürücü modelidir. En son özelliklerden yararlanmak için WiFiCx kullanmanızı öneririz. WDI sürücü modeli artık bakım modundadır ve yalnızca yüksek öncelikli düzeltmeler alır.

WLAN Cihaz Sürücüsü Arabirimi (WDI), hem masaüstü sürümleri için Windows 10 (Home, Pro, Enterprise ve Education) hem de Windows 10 Mobile için Wi-Fi sürücülerine yönelik yeni Evrensel Windows sürücü modelidir. WLAN cihaz üreticisi, Windows 10 işletim sistemi uygulamasıyla çalışmak için bir WDI miniport sürücüsü yazar. WDI, cihaz üreticilerinin önceki Yerel WLAN sürücü modeline göre daha az kod yazmasına olanak tanır. Windows 10'da kullanıma sunulan tüm yeni WLAN özellikleri WDI tabanlı sürücüler gerektirir.

Satıcı tarafından sağlanan yerel WLAN sürücüleri Windows 10'da çalışmaya devam eder, ancak işlevsellik, geliştirildiği Windows sürümüyle sınırlıdır.

WDI gereksinimleri ve arabirim belirtimi bu tasarım kılavuzunda belgelenmiştir. Yeni modelin temel hedefleri şunlardır:

  • Windows WLAN sürücülerinin kalitesini ve güvenilirliğini artırın.
  • Geçerli sürücü modelinin karmaşıklığını azaltın; bu da IHV sürücüsünün karmaşıklığını azaltır ve IHV sürücü geliştirmesinin genel maliyetini azaltır.

Bu belgelerin odak noktası, Windows ile IHV sürücü bileşeni arasındaki Wi-Fi işlemlerinin akışını ve davranışını belirtmektir. Yazılım arabirimi imzasını (örneğin, cihaz sürücüsü arabirim modeli) ve IHV bileşeninin Windows'a nasıl yüklendiğiyle ilgili ayrıntıları kapsamaz.

Tasarım ilkeleri

Aşağıdaki ilkeler, bu protokolün genel modelini ve tasarımını yönlendirdi.

  1. Konak bileşeni ile IHV bileşeni/cihazı arasındaki gereksiz trafiği en aza indirin. Bu, özellikle doğal olarak sohbet eden SDIO gibi otobüslerdeki uygulamalar için önemlidir.
  2. Wi-Fi işlevselliğin (özellikle düşük gecikme süresiyle gerçekleştirilmesi gereken işlevler) cihaz tarafından işlenmesi beklenir.
  3. Mevzuatla ilgili tüm işlevler IHV bileşeninde bulunur ve IHV tarafından denetlenmektedir.
  4. Windows deneyimi, konak bileşeni ve Windows işletim sistemi tarafından denetlenilir.
  5. Windows, asılı cihazları yeniden canlandırma özelliğine sahiptir. IHV bileşenini yeniden programlamak ve 10 saniye içinde kurtarmak için yeterli duruma sahiptir.
  6. Çok fazla sistem belleği veya hızlı işlemci gerektiren ve satıcıya özgü olmayan işlemler konak tarafından işlenir.

Tanımlar

Süre Açıklama

Aygıt

Otobüse bağlanan donanımın tamamı. Cihazın içinde birden çok radyo olabilir (özellikle Wi-Fi ve Bluetooth).

Wi-Fi bağdaştırıcısı

Cihazın bu spesifikasyonda belirtildiği gibi Wi-Fi işlevselliğini uygulayan bölümü.

Liman

Belirli bir bağlantı için MAC ve PHY durumunu temsil eden nesne.

IHV bileşeni

Ana sisteme Wi-Fi Bağdaştırıcı/Cihazını temsil eden IHV tarafından geliştirilen yazılım bileşeni.

Sunucu

Bu belirtimde açıklanan arabirimleri kullanarak IHV bileşeniyle etkileşim kuran konak tarafı Microsoft/işletim sistemi yazılımı.

Üst Uç Sürücüsü (UE)

UE, bu belgelerde WDI olarak adlandırılan WdiWiFi sürücüsünü ifade eder. UE ve Lower Edge (LE) IHV sürücüsü, tam bir NDIS miniport sürücüsü oluşturacak şekilde birleştirilir. UE, temel Wi-Fi mantığını uygular.

Alt Kenar Sürücü (LE)

LE, alt kenardaki IHV sürücüsünü ifade eder. LE ve UE, eksiksiz bir NDIS miniport sürücüsünde birleştirilir. LE, veri yolu ve donanıma özgü işlevleri uygular.

İşlev Düzeyi Sıfırlama (FLR)

PCIe belirtiminde olduğu gibi İşlev Düzeyi Sıfırlama. Bu terim, bir işlevin sıfırlanmasını, bileşik işleve sahip olabilecek tüm cihazın sıfırlanmasını ifade eder. Bu tür bir kapsamın sıfırlanması aynı cihazdaki diğer işlevleri etkilemez.

Platform Düzeyinde Sıfırlama (PLR)

Platform Düzeyinde Sıfırlama. Bu sıfırlama yöntemi bir cihazdaki tüm işlevleri etkiler. Maliyeti ve ayak izini azaltmak için cihazda birden çok işlev oluşturmak çok popülerdir. Örneğin, Bluetooth genellikle yonga üzerinde Wi-Fi ile oluşturulur. Ancak, böyle bir sıfırlama yöntemi cihazdaki tüm işlev birimlerini sıfırlar.

Sıfırlama Kurtarma (RR)

RR, Sıfırlama ve Kurtarma olay dizisini ifade eder.

FLR için bu şunları içerir:

  • NDIS, isteği Wi-Fi işlevini sıfırlamak için veri yoluna iletir.
  • Üretici yazılımı bağlamının sürücü tarafından kurtarılması.
  • Sıfırlamadan önce bağlandıysa erişim noktasına yeniden bağlanın.

PLR için buna şunlar dahildir:

  • NDIS'e yapılan isteği, isteği veri yoluna iletir. Bus, cihazı sürpriz bir şekilde kaldırmak için PnP ile etkileşim kurar.
  • Cihazın yeniden numaralandırması.
  • Cihaz yığınını yeniden oluşturma.
  • Wi-Fi yeniden başlatılır ve yeniden bağlanır.

WDI komutları

UE, WDI OID'lerini gönderir ve LE geri çağrıları yapar. Bunların tümü WDI komutları olarak adlandırılır.

MAC Adresi Rastgele Seçme

Windows 10 kullanıcılarının gizliliğini geliştirmek için, yapılandırılmış Wi-Fi MAC adresleri, belirli bir Wi-Fi ağına bağlanmadan önce veya belirli koşullarda tarama başlatırken olduğu gibi bazı durumlarda kullanılır. Bu yalnızca istasyon bağlantı noktası için geçerlidir. Sistem, rastgele seçmenin uygun şekilde kullanılmasını sağlar, bu nedenle önemli bağlantı senaryoları bozulmaz. Sistem, tarama veya bağlanma komutu göndermeden önce OID_WDI_TASK_DOT11_RESET komutları vererek adres değişikliklerini yönetir. Reset komutunun parametreleri isteğe bağlı MAC adresi gibi bir bağımsız değişken içerebilir. Parametre varsa, MAC adresi belirtilen değere sıfırlanır. Eğer yoksa, MAC adresi geçerli değerine kalır. Rastgele MAC adreslerini yapılandırırken, işletim sistemi IEEE802 adresleri için tanımlanan "yerel olarak yönetilen" biçimini kullanır.

ECSA

Genişletilmiş Kanal Geçişi Duyurusu.

WDI MiniPort Sürücü Referansı