Inscription d’une interface réseau
Chaque fois qu’un ordinateur redémarre, NDIS commence par une liste vide d’interfaces réseau inscrites. Un fournisseur d’interface appelle la fonction NdisIfRegisterInterface chaque fois qu’il démarre ou détecte une interface et que sa valeur NET_LUID est connue. Le mécanisme de démarrage ou de détection d’une interface est spécifique à l’application.
NdisIfRegisterInterface retourne NDIS_STATUS_SUCCESS uniquement si NDIS a correctement ajouté l’interface spécifiée à sa liste d’interfaces connues sur l’ordinateur. Dans ce cas, NdisIfRegisterInterface retourne un index d’interface au niveau du paramètre pIfIndex . Toutefois, un appel à NdisIfRegisterInterface n’implique pas que l’interface est active ; cet appel garantit uniquement que l’interface existe. NdisIfRegisterInterface retourne NDIS_STATUS_RESOURCES si NDIS ne dispose pas de ressources suffisantes pour inscrire l’interface. NdisIfRegisterInterface peut également retourner d’autres valeurs de status NDIS.
Le paramètre ProviderIfContext de NdisIfRegisterInterface contient un handle dans la zone de contexte de l’appelant pour l’interface. Ce handle est passé aux fonctions de définition et de requête OID de l’appelant. Le paramètre pIfInfo contient un pointeur vers une structure NET_IF_INFORMATION qui inclut des informations sur l’interface.
Les rubriques suivantes fournissent plus d’informations sur les interfaces réseau que NdisIfRegisterInterface a correctement inscrites :