Registrando uma interface de rede

Sempre que um computador é reiniciado, o NDIS começa com uma lista vazia de interfaces de rede registradas. Um provedor de interface chama a função NdisIfRegisterInterface sempre que inicia ou deteta uma interface e o seu valor NET_LUID é conhecido. O mecanismo para iniciar ou detetar 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 está ativa; Esta chamada garante apenas que a interface existe. NdisIfRegisterInterface retorna 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; este identificador é passado para as funções de consulta e definição OID do chamador. O parâmetro pIfInfo contém um ponteiro para uma estrutura NET_IF_INFORMATION que inclui informações sobre a interface.

Os seguintes tópicos fornecem informações adicionais sobre as interfaces de rede que são registadas com sucesso por NdisIfRegisterInterface.

Alocar um índice de interface

Informações da Interface de Rede