Estensione di classe WDF della scheda di rete (NetAdapterCx)

  • Articolo

Panoramica

A partire da Windows 10 versione 2004, Windows Driver Kit (WDK) include un modulo di estensione della classe WDF (NetAdapterCx) della scheda di rete che consente di scrivere un driver client basato su KMDF per un controller di interfaccia di rete . A partire da Windows 11, versione 24H2, la versione UMDF di NetAdapterCx consente ai driver NIC di funzionare in modalità utente. NetAdapterCx offre la potenza e la flessibilità di WDF e le prestazioni di rete di NDIS e semplifica la scrittura di un driver per la scheda di interfaccia di rete.

Nelle versioni precedenti di Windows, WDF e NDIS presentavano vantaggi individuali, ma non interoperativo. L'unico modo per scrivere un driver NIC era scrivere un driver miniport NDIS. Per usare WDF in un driver miniport NDIS, è stato necessario scrivere codice aggiuntivo nel driver e, anche in questo caso, si è avuto accesso solo a un piccolo subset di funzionalità di WDF.

Con il modello NetAdapterCx, al contrario, si scrive un driver WDF reale per la scheda di interfaccia di rete. Ciò significa che il driver NetAdapterCx ha accesso alle funzionalità WDF complete, nonché alle API specifiche della rete e al supporto di I/O dall'estensione della classe NetAdapter. Come illustrato nel diagramma a blocchi riportato di seguito, NetAdapterCx funziona ancora in background con NDIS, ma gestisce tutte le interazioni con NDIS per conto dell'utente.

Diagramma che mostra l'architettura NetAdapterCx.

Informazioni aggiuntive

Il video seguente Estensione classe scheda di rete: Panoramica illustra i vantaggi dell'uso di NetAdapterCx.

Per informazioni su come convertire un driver miniport NDIS 6.x nel modello di driver NIC NetAdapterCx, vedere Conversione di driver miniport NDIS a NetAdapterCx.

Per iniziare subito a lavorare con gli esempi di driver in GitHub, clonare il repository NetAdapter-Cx-Driver-Samples .

Per visualizzare il codice sorgente per NetAdapterCx stesso o eseguire il debug dettagliato, vedere il repository Network-Adapter-Class-Extension su GitHub.

Se si vuole collaborare con Microsoft durante lo sviluppo di un driver client NetAdapterCx o se si hanno commenti e suggerimenti sull'estensione della classe, inviare un messaggio di posta elettronica.

Il video seguente Estensione della classe scheda di rete: Roadmap e collaborazione illustra le future opportunità di roadmap e collaborazione.

Argomenti

In questa sezione sono descritti gli argomenti seguenti: