Netzwerkadapter WDF-Klassenerweiterung (NetAdapterCx)
Übersicht
Ab Windows 10, Version 2004, enthält das Windows Driver Kit (WDK) ein WDF-Klassenerweiterungsmodul (Network Adapter WDF Class Extension Module, NetAdapterCx), mit dem Sie einen KMDF-basierten Clienttreiber für einen Netzwerkschnittstellencontroller (Network Interface Controller, NIC) schreiben können. Ab Windows 11, Version 24H2, ermöglicht die UMDF-Version von NetAdapterCx den Betrieb von NIC-Treibern im Benutzermodus. NetAdapterCx bietet Ihnen die Leistungsfähigkeit und Flexibilität von WDF und die Netzwerkleistung von NDIS und erleichtert das Schreiben eines Treibers für Ihre NIC.
In früheren Versionen von Windows hatten WDF und NDIS individuelle Vorteile, funktionierten aber nicht gut. Die einzige Möglichkeit zum Schreiben eines NIC-Treibers war das Schreiben eines NDIS-Miniporttreibers. Um WDF in einem NDIS-Miniporttreiber zu verwenden, mussten Sie zusätzlichen Code in Ihrem Treiber schreiben, und sogar dann hatten Sie nur Zugriff auf eine kleine Teilmenge der WDF-Funktionalität.
Mit dem NetAdapterCx-Modell schreiben Sie dagegen einen echten WDF-Treiber für Ihre NIC. Dies bedeutet, dass Ihr NetAdapterCx-Treiber Zugriff auf vollständige WDF-Funktionen sowie netzwerkspezifische APIs und E/A-Unterstützung von der NetAdapter-Klassenerweiterung hat. Wie im folgenden Blockdiagramm gezeigt, funktioniert NetAdapterCx weiterhin hinter den Kulissen mit NDIS, behandelt jedoch alle Interaktionen mit NDIS in Ihrem Auftrag.
Zusätzliche Informationen
Im Video Netzwerkadapter-Klassenerweiterung: Übersicht werden die Vorteile der Verwendung von NetAdapterCx erläutert.
Informationen zum Portieren eines NDIS 6.x Miniporttreibers zum NetAdapterCx NIC-Treibermodell finden Sie unter Portieren von NDIS-Miniporttreibern zu NetAdapterCx.
Um sofort mit den Treiberbeispielen auf GitHub zu arbeiten, klonen Sie das NetAdapter-Cx-Driver-Samples-Repository.
Wenn Sie den Quellcode für NetAdapterCx selbst anzeigen oder schrittweises Debuggen ausführen möchten, sehen Sie sich unser Netzwerkadapter-Klassenerweiterung-Repository auf GitHub an.
Wenn Sie bei der Entwicklung eines NetAdapterCX-Clienttreibers mit Microsoft zusammenarbeiten möchten oder Feedback zur Klassenerweiterung haben, senden Sie uns bitte eine E-Mail.
Das Video : Netzwerkadapter-Klassenerweiterung: Roadmap und Zusammenarbeit erläutert zukünftige Roadmap- und Zusammenarbeitsmöglichkeiten.
Themen
Dieser Abschnitt enthält die folgenden Themen:
- Portieren von NDIS-Miniporttreibern zu NetAdapterCx
- Erstellen eines NetAdapterCx-Clienttreibers
- INF-Dateien für NetAdapterCx-Clienttreiber
- NetAdapterCx im Benutzermodus
- Verwalten der Lebensdauer von Objekten in NetAdapterCx
- Zugriff auf Konfigurationsinformationen
- Debuggen eines NetAdapterCx-Clienttreibers
- Übertragen von Netzwerkdaten
- NetAdapterCx-Empfangsskalierung (RSS)
- Konfigurieren der Energieverwaltung
- NDIS-WDF-Funktionsäquivalente
- NetAdapterCx-Einschränkungen
- Mobile Broadband WDF Class Extension (WDF-Klassenerweiterung für mobiles Breitband)
- Wi-Fi-WDF-Klassenerweiterung (WiFiCx)