Registrando um adaptador de rede
Sempre que um computador é reiniciado, o NDIS começa com uma lista vazia de adaptadores de rede registrados. Um provedor de interface chama a função NdisIfRegisterInterface sempre que inicia ou detecta uma interface e seu valor de NET_LUID é conhecido. O mecanismo para iniciar ou detectar uma interface é específico do aplicativo.
NdisIfRegisterInterface retornará NDIS_STATUS_SUCCESS somente se o NDIS adicionar com êxito a interface especificada à sua lista de interfaces conhecidas no computador. Nesse caso, NdisIfRegisterInterface retorna um índice de interface no parâmetro pIfIndex . No entanto, uma chamada para NdisIfRegisterInterface não implica que a interface esteja ativa; essa chamada garante apenas que a interface exista. NdisIfRegisterInterface retornará NDIS_STATUS_RESOURCES se o NDIS não tiver recursos suficientes disponíveis para registrar a interface. NdisIfRegisterInterface também pode retornar outros valores de status NDIS.
O parâmetro ProviderIfContext de NdisIfRegisterInterface contém um identificador para a área de contexto do chamador para a interface – esse identificador é passado para a consulta OID do chamador e define funções. O parâmetro pIfInfo contém um ponteiro para uma estrutura NET_IF_INFORMATION que inclui informações sobre a interface.
Os tópicos a seguir fornecem mais informações sobre interfaces de rede que NdisIfRegisterInterface registra com êxito :