Estensione di classe WDF della scheda di rete (NetAdapterCx)
Panoramica
A partire da Windows 10, versione 2004, il Windows Driver Kit (WDK) include un modulo di estensione della classe WDF per adattatori di rete (NetAdapterCx) che consente di scrivere un driver client basato su KMDF per un Network Interface Controller (NIC). 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 interoperavano bene. 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.
Informazioni aggiuntive
Il seguente video Estensione classe adattatore 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 Porting NDIS miniport drivers to NetAdapterCx.
Per iniziare subito a lavorare con i campioni di driver su GitHub, clona il repository NetAdapter-Cx-Driver-Samples.
Per visualizzare il codice sorgente per NetAdapterCx 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 ha un feedback sull'estensione della classe, inviare un messaggio di posta elettronica .
Il video seguente Network Adapter Class Extension: Roadmap and Collaboration discute i piani futuri e le opportunità di collaborazione.
Argomenti
Questa sezione contiene gli argomenti seguenti:
- conversione dei driver miniport NDIS in NetAdapterCx
- Creazione di un driver client NetAdapterCx
- File INF per i driver client di NetAdapterCx
- NetAdapterCx in modalità utente
- Gestione della durata degli oggetti in NetAdapterCx
- Accesso alle informazioni di configurazione
- debug di un driver client NetAdapterCx
- Trasferimento dei dati di rete
- Scalabilità della ricezione di NetAdapterCx (RSS)
- Configurazione della gestione dell’energia
- NDIS-WDF funzioni equivalenti
- limitazioni di NetAdapterCx
- Estensione della classe WDF per la banda larga mobile (MBB) (MBBCx)
- Wi-Fi estensione della classe WDF (WiFiCx)