Rejestrowanie interfejsu sieciowego

Za każdym razem, gdy komputer zostanie uruchomiony ponownie, usługa NDIS rozpoczyna się od pustej listy zarejestrowanych interfejsów sieciowych. Dostawca interfejsu wywołuje funkcję NdisIfRegisterInterface za każdym razem, gdy uruchamia lub wykrywa interfejs, a znana jest wartość jego NET_LUID. Mechanizm uruchamiania lub wykrywania interfejsu jest specyficzny dla aplikacji.

NdisIfRegisterInterface zwraca NDIS_STATUS_SUCCESS tylko wtedy, gdy NDIS pomyślnie doda określony interfejs do listy znanych interfejsów na komputerze. W tym przypadku NdisIfRegisterInterface zwraca indeks interfejsu w parametrze pIfIndex. Jednak wywołanie NdisIfRegisterInterface nie oznacza, że interfejs jest aktywny; to wywołanie gwarantuje tylko, że interfejs istnieje. NdisIfRegisterInterface zwraca NDIS_STATUS_RESOURCES, jeśli NDIS nie ma wystarczających zasobów, aby zarejestrować interfejs. NdisIfRegisterInterface może również zwrócić inne wartości stanu NDIS.

Parametr ProviderIfContext funkcji NdisIfRegisterInterface zawiera uchwyt do obszaru kontekstu wywołującego dla interfejsu — ten uchwyt jest przekazywany do funkcji zapytania i ustawiania OID obiektu wywołującego. Parametr pIfInfo zawiera wskaźnik do struktury NET_IF_INFORMATION zawierającej informacje o interfejsie.

Poniższe tematy zawierają więcej informacji na temat interfejsów sieciowych, które zostały pomyślnie zarejestrowane przez NdisIfRegisterInterface.

Przydzielanie Indeksu Interfejsu

informacje o interfejsie sieciowym