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)