Network Adapter WDF Class Extension (NetAdapterCx)

Visão geral

A partir do Windows 10, versão 2004, o WDK (Windows Driver Kit) inclui um módulo Network Adapter WDF Class Extension (NetAdapterCx), que permite gravar um driver de cliente baseado em KMDF para um Network Interface Controller (NIC). 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, além de facilitar a gravação de um driver para sua NIC.

Em versões anteriores do Windows, WDF e NDIS tinham vantagens individuais, mas não interoperavam 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 miniporta NDIS, você tinha que escrever código extra em seu driver e, mesmo assim, você só tinha acesso a um pequeno subconjunto de funcionalidade 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 WDF completa, bem como APIs específicas de rede e suporte a E/S da extensão de classe NetAdapter. Como mostrado no diagrama de blocos abaixo, o NetAdapterCx ainda funciona nos bastidores com o NDIS, mas ele lida com toda a interação com o NDIS em seu nome.

Informações adicionais

O seguinte vídeo Network Adapter Class Extension: Visão geral trata das vantagens 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 amostras 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:

• Como portar drivers de miniporta NDIS para NetAdapterCx
• Como criar um driver de cliente NetAdapterCx
• Arquivos INF para drivers de cliente NetAdapterCx
• User-Mode NetAdapterCx
• Como gerenciar o tempo de vida de objetos no NetAdapterCx
• Como acessar informações de configuração
• Como depurar um driver de cliente NetAdapterCx
• Como transferir dados de rede
• NetAdapterCx receive side scaling (RSS)
• Configurando o gerenciamento de energia
• Equivalentes da função NDIS-WDF
• Limitações de NetAdapterCx
• Extensão de classe mobile Broadband (MBB) (MBBCx)
• Extensão de classe WDF Wi-Fi (WiFiCx)