Extension de classe WDF pour adaptateur de réseau (NetAdapterCx)
Vue d’ensemble
À partir de Windows 10, version 2004, le kit de pilotes Windows (WDK) comprend un module Network Adapter WDF Class Extension (NetAdapterCx) qui vous permet d'écrire un pilote client basé sur KMDF pour un contrôleur d'interface réseau (NIC). À partir de Windows 11, version 24H2, la version UMDF de NetAdapterCx permet aux pilotes NIC de fonctionner en mode utilisateur. NetAdapterCx vous offre la puissance et la flexibilité de WDF et les performances réseau de NDIS, et facilite l'écriture d'un pilote pour votre NIC.
Dans les versions précédentes de Windows, WDF et NDIS présentaient chacun des avantages, mais n'interopéraient pas bien. La seule façon d'écrire un pilote de carte d'interface réseau était d'écrire un pilote de miniport NDIS. Pour utiliser WDF dans un pilote de miniport NDIS, vous deviez écrire du code supplémentaire dans votre pilote, et même dans ce cas, vous n'aviez accès qu'à un petit sous-ensemble des fonctionnalités de WDF.
Avec le modèle NetAdapterCx, à l'inverse, vous écrivez un véritable pilote WDF pour votre NIC. Cela signifie que votre pilote NetAdapterCx a accès à toutes les fonctionnalités du WDF, ainsi qu'aux API spécifiques au réseau et à la prise en charge des E/S de l'extension de classe NetAdapter. Comme le montre le diagramme ci-dessous, NetAdapterCx travaille toujours en coulisses avec NDIS, mais il gère toutes les interactions avec NDIS en votre nom.
Informations supplémentaires
La vidéo suivante Network Adapter Class Extension : Overview présente les avantages de l'utilisation de NetAdapterCx.
Pour savoir comment porter un pilote miniport NDIS 6.x vers le modèle de pilote NIC NetAdapterCx, voir Portage des pilotes miniport NDIS vers NetAdapterCx.
Pour commencer à travailler immédiatement avec des exemples de pilotes sur GitHub, clonez notre référentiel NetAdapter-Cx-Driver-Samples.
Pour voir le code source de NetAdapterCx lui-même, ou effectuer un débogage étape par étape, consultez notre référentiel Network-Adapter-Class-Extension sur GitHub.
Si vous souhaitez collaborer avec Microsoft dans le cadre du développement d'un pilote client NetAdapterCx ou si vous avez des commentaires sur l'extension de classe, veuillez nous envoyer un e-mail.
La vidéo suivante Network Adapter Class Extension : Roadmap and Collaboration (feuille de route et collaboration) traite de la feuille de route future et des possibilités de collaboration.
Rubriques
Cette section contient les rubriques suivantes :
- Portage des pilotes miniport NDIS vers NetAdapterCx
- Création d'un pilote client NetAdapterCx
- Fichiers INF pour les pilotes clients NetAdapterCx
- NetAdapterCx en mode utilisateur
- Gestion de la durée de vie des objets dans NetAdapterCx
- Accès aux informations de configuration
- Débogage d'un pilote client NetAdapterCx
- Transfert de données réseau
- Mise à l'échelle côté réception (RSS) de NetAdapterCx
- Configuration de la gestion de l’alimentation
- Équivalents des fonctions NDIS-WDF
- Limitations de NetAdapterCx
- Extension de classe WDF pour le haut débit mobile (MBB) (MBBCx)
- Extension de la classe Wi-Fi WDF (WiFiCx)