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.
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 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. O driver NetAdapterCx tem acesso à funcionalidade completa do WDF, bem como a APIs específicas de rede e suporte de E/S da extensão de classe NetAdapter. Conforme mostrado no diagrama de bloco a seguir, 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 se 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.
Artigos
Esta seção contém os seguintes artigos:
- 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
- Como gerenciar o tempo de vida útil de objetos no NetAdapterCx
- Como acessar 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)