Průvodce návrhem ovladače WDI Miniport

Důležité

WiFiCx je nový model ovladačů Wi-Fi vydaný ve Windows 11. Doporučujeme používat WiFiCx k využití nejnovějších funkcí. Model ovladače WDI je nyní v režimu údržby a bude dostávat pouze opravy s vysokou prioritou.

Rozhraní WDI (WLAN Device Driver Interface) je nový univerzální model ovladačů systému Windows pro ovladače Wi-Fi pro windows 10 pro desktopové edice (Home, Pro, Enterprise a Education) a Windows 10 Mobile. Výrobce zařízení WLAN zapíše ovladač miniportu WDI pro práci s implementací operačního systému Windows 10. WDI umožňuje výrobcům zařízení psát méně kódu než předchozí nativní model ovladače WLAN. Všechny nové funkce WLAN představené ve Windows 10 vyžadují ovladače založené na WDI.

Nativní ovladače WLAN dodané dodavatelem nadále fungují ve Windows 10, ale funkce jsou omezené na verzi Windows, pro kterou byly vyvinuty.

Požadavky WDI a specifikace rozhraní jsou popsané v tomto průvodci návrhem. Mezi klíčové cíle nového modelu patří:

• Zlepšení kvality a spolehlivosti ovladačů Windows WLAN.
• Snižte složitost současného modelu ovladače, což následně sníží složitost ovladače IHV a sníží celkové náklady na vývoj ovladače IHV.

Cílem této dokumentace je určit tok a chování operací Wi-Fi mezi Windows a komponentou ovladače IHV. Nevztahuje se na podpis softwarového rozhraní (například model rozhraní ovladače zařízení) a podrobnosti o tom, jak je komponenta IHV načtena ve Windows.

Principy návrhu

Následující principy se řídí celkovým modelem a návrhem tohoto protokolu.

1. Minimalizujte komunikační zátěž provozu mezi hostitelskou komponentou a IHV komponentou/zařízením. To je zvlášť důležité pro implementace na sběrnicích, jako je SDIO, které jsou ze své podstaty komunikativní.
2. Wi-Fi funkčnost (zejména funkce, které musí být provedeny s nízkou latencí) by měla být zpracována zařízením.
3. Všechny regulační funkce se nacházejí v komponentě IHV a řídí se IHV.
4. Prostředí Systému Windows je řízeno hostitelskou komponentou a operačním systémem Windows.
5. Systém Windows má možnost oživit zařízení, která se zablokují. Má dostatek stavu k přeprogramování komponenty IHV a obnovení do 10 sekund.
6. Operace, které vyžadují velké množství systémové paměti nebo rychlé procesory a nejsou specifické pro dodavatele, se zpracovávají hostitelem.

Definice

termín	Popis
Zařízení	Celý hardware, který se připojuje ke sběrnici. Zařízení může mít v něm více rádií (zejména Wi-Fi a Bluetooth).
adaptér Wi-Fi	Konkrétní část zařízení, která implementuje funkci Wi-Fi podle popisu v této specifikaci.
Přístav	Objekt, který představuje stav MAC a PHY pro konkrétní připojení.
Komponenta IHV	Softwarová komponenta vyvinutá společností IHV, která představuje Wi-Fi Adaptér/zařízení pro hostitele.
Hostitel	Software microsoftu nebo operačního systému na straně hostitele, který komunikuje s komponentou IHV pomocí rozhraní popsaných v této specifikaci.
Upper Edge Driver (UE)	UE odkazuje na ovladač WdiWiFi označovaný jako WDI v této dokumentaci. Ovladač UE a ovladač Dolního Hraničního okraje (LE) se kombinují do kompletního miniportového ovladače NDIS. UE implementuje základní logiku Wi-Fi.
Ovladač Lower Edge (LE)	LE odkazuje na ovladač IHV na dolním okraji. LE a UE se sjednocují v kompletní miniportový ovladač NDIS. Le implementuje funkce specifické pro sběrnici a hardware.
Resetování funkční úrovně (FLR)	Resetování úrovně funkčnosti, stejně jako ve specifikaci PCIe. Tento termín označuje resetování funkce a resetování kompletního zařízení, které může mít složenou funkci. Resetování takového rozsahu nenaruší ostatní funkce na stejném zařízení.
Resetování na úrovni platformy (PLR)	Resetování na úrovni platformy Tato metoda resetování má vliv na všechny funkce na zařízení. Je velmi populární vytvářet na zařízení více funkcí, aby se snížily náklady a nároky. Například je Bluetooth obvykle sestaven s Wi-Fi na čipu. Taková metoda resetování ale resetuje všechny jednotky funkcí v zařízení.
Obnovení nastavení (RR)	RR odkazuje na posloupnost událostí resetování a obnovení. Pro FLR to zahrnuje: Požadavek na NDIS, který jej přeposílá na sběrnici, aby resetoval funkci Wi-Fi. Obnovení kontextu firmwaru ovladačem Znovu se připojte k přístupovému bodu, pokud byl připojen před resetováním. V případě PLR to zahrnuje: Žádost na rozhraní NDIS, která tuto žádost předává sběrnici. Sběrnice komunikuje s PnP, aby neočekávaně vyjmula zařízení. Znovu vyčíslení zařízení Obnovení vrstvy zařízení Wi-Fi se restartuje a znovu se připojí.
Příkazy WDI	UE odesílá identifikátory OID WDI a volá zpětná volání LE. Všechny tyto příkazy se nazývají příkazy WDI.
Randomizace adres MAC	Aby se zlepšila ochrana osobních údajů uživatelů Windows 10, používají se nakonfigurované adresy Wi-Fi MAC za určitých okolností, například před připojením ke konkrétní síti Wi-Fi nebo při inicializování kontrol v určitých podmínkách. To platí jenom pro port stanice. Systém zajišťuje, aby se správně používala náhodnost, takže důležité scénáře připojení zůstávají neporušené. Systém spravuje změny adres vydáním příkazů OID_WDI_TASK_DOT11_RESET před vydáním příkazu pro kontrolu nebo připojení. Parametry příkazu resetování zahrnují volitelný argument adresy MAC. Pokud argument existuje, adresa MAC se resetuje na zadanou hodnotu. Pokud chybí, adresa MAC zůstane na aktuální hodnotě. Při konfiguraci randomizovaných adres MAC používá operační systém formát "místně spravovaný" definovaný pro IEEE802 adresy.
ECSA	Oznámení o přepnutí rozšířeného kanálu

Související témata

Referenční informace o ovladači WDI Miniport