Registrieren einer Netzwerkschnittstelle
Wenn ein Computer neu gestartet wird, beginnt NDIS mit einer leeren Liste registrierter Netzwerkschnittstellen. Ein Schnittstellenanbieter ruft die NdisIfRegisterInterface-Funktion auf, wenn er eine Schnittstelle startet oder erkennt und deren NET_LUID Wert bekannt ist. Der Mechanismus zum Starten oder Erkennen einer Schnittstelle ist anwendungsspezifisch.
NdisIfRegisterInterface gibt NDIS_STATUS_SUCCESS nur zurück, wenn NDIS die angegebene Schnittstelle erfolgreich der Liste der bekannten Schnittstellen auf dem Computer hinzufügt. In diesem Fall gibt NdisIfRegisterInterface einen Schnittstellenindex am pIfIndex-Parameter zurück. Ein Aufruf von NdisIfRegisterInterface impliziert jedoch nicht, dass die Schnittstelle aktiv ist. Dieser Aufruf garantiert nur, dass die -Schnittstelle vorhanden ist. NdisIfRegisterInterface gibt NDIS_STATUS_RESOURCES zurück, wenn NDIS nicht über genügend Ressourcen zum Registrieren der Schnittstelle verfügt. NdisIfRegisterInterface kann auch andere NDIS-status-Werte zurückgeben.
Der ProviderIfContext-Parameter von NdisIfRegisterInterface enthält ein Handle für den Kontextbereich des Aufrufers für die Schnittstelle. Dieses Handle wird an die OID-Abfrage und die Setfunktionen des Aufrufers übergeben. Der pIfInfo-Parameter enthält einen Zeiger auf eine NET_IF_INFORMATION-Struktur , die Informationen zur Schnittstelle enthält.
Die folgenden Themen enthalten weitere Informationen zu Netzwerkschnittstellen, die von NdisIfRegisterInterface erfolgreich registriert wurden: