Extensão de classe WDF do adaptador de rede (NetAdapterCx)
Visão geral
A partir do Windows 10, versão 2004, o WDK (Windows Driver Kit) inclui um módulo de extensão de classe WDF do adaptador de rede (NetAdapterCx) que permite que você escreva um driver de cliente baseado em KMDF para um NIC (Controlador de Interface de Rede). A partir do Windows 11, versão 24H2, a versão UMDF do NetAdapterCx permite que os drivers NIC operem no modo de usuário. O NetAdapterCx oferece o poder e a flexibilidade do WDF e o desempenho de rede do NDIS e facilita a gravação de um driver para sua NIC.
Nas versões anteriores do Windows, o WDF e o NDIS tinham vantagens individuais, mas não interoperam bem. A única maneira de escrever um driver de NIC era escrever um driver de miniporta NDIS. Para usar o WDF em um driver de miniporto NDIS, você precisava escrever código extra no driver e, mesmo assim, só tinha acesso a um pequeno subconjunto de funcionalidade do WDF.
Com o modelo NetAdapterCx, por outro lado, você escreve um driver WDF real para sua NIC. Isso significa que o driver NetAdapterCx tem acesso à funcionalidade completa do WDF, bem como APIs específicas de rede e suporte de entrada/saída (E/S) da extensão de classe NetAdapter. Conforme mostrado no diagrama de bloco abaixo, o NetAdapterCx ainda funciona nos bastidores com o NDIS, mas lida com toda a interação com o NDIS em seu nome.
Informações adicionais
O vídeo a seguir, Extensão de Classe do Adaptador de Rede: Visão Geral, discute os benefícios do uso do NetAdapterCx.
Para saber como portar um driver de miniporta NDIS 6.x para o modelo de driver de NIC NetAdapterCx, consulte Como portar drivers de miniporta NDIS para NetAdapterCx.
Para começar a trabalhar imediatamente com exemplos de driver no GitHub, clone nosso repositório NetAdapter-Cx-Driver-Samples.
Para ver o código-fonte do próprio NetAdapterCx ou executar a depuração passo a passo, consulte nosso repositório Network-Adapter-Class-Extension no GitHub.
Se você quer trabalhar com a Microsoft para desenvolver um driver de cliente NetAdapterCx ou tiver comentários sobre a extensão de classe, envie-nos um email.
O seguinte vídeo Network Adapter Class Extension: Roteiro e colaboração é sobre o roteiro futuro e as oportunidades de colaboração.
Tópicos
Esta seção contém os seguintes tópicos:
- Portabilidade de drivers de miniporta NDIS para NetAdapterCx
- Construindo um driver cliente NetAdapterCx
- Arquivos INF para drivers de cliente NetAdapterCx
- NetAdapterCx no modo de usuário
- Gerenciando o tempo de vida dos objetos no NetAdapterCx
- Acessando informações de configuração
- Depurando um driver de cliente NetAdapterCx
- Transferência de dados de rede
- NetAdapterCx receive side scaling (RSS)
- Configurando o gerenciamento de energia
- Equivalentes da função NDIS-WDF
- limitações do NetAdapterCx
- Extensão de classe mobile Broadband (MBB) (MBBCx)
- Extensão de classe WDF Wi-Fi (WiFiCx)