Een netwerkinterface registreren

Wanneer een computer opnieuw wordt opgestart, begint NDIS met een lege lijst met geregistreerde netwerkinterfaces. Een interfaceprovider roept de NdisIfRegisterInterface- functie aan wanneer deze een interface start of detecteert en de bijbehorende NET_LUID waarde bekend is. Het mechanisme voor het starten of detecteren van een interface is toepassingsspecifiek.

NdisIfRegisterInterface retourneert alleen NDIS_STATUS_SUCCESS als NDIS de opgegeven interface succesvol toevoegt aan zijn lijst van bekende interfaces op de computer. In dit geval retourneert NdisIfRegisterInterface een interfaceindex op de parameter pIfIndex. Een aanroep van NdisIfRegisterInterface impliceert echter niet dat de interface actief is; deze aanroep garandeert alleen dat de interface bestaat. NdisIfRegisterInterface retourneert NDIS_STATUS_RESOURCES als NDIS niet over voldoende resources beschikt om de interface te registreren. NdisIfRegisterInterface kan ook andere NDIS-statuswaarden retourneren.

De ProviderIfContext parameter van NdisIfRegisterInterface bevat een ingang voor het contextgebied van de beller voor de interface. Deze ingang wordt doorgegeven aan de OID-query van de aanroeper en stelt functies in. De parameter pIfInfo bevat een aanwijzer naar een NET_IF_INFORMATION structuur met informatie over de interface.

De volgende onderwerpen bevatten meer informatie over netwerkinterfaces die met succes worden geregistreerd door NdisIfRegisterInterface:

Een interface-index toewijzen

netwerkinterfacegegevens