Interfejs programowania sieciowego

Interfejs programowania sieciowego lub NPI definiuje interfejs między modułami sieciowymi , które mogą być dołączone do siebie. Moduł klienta zarejestrowany jako klient określonego serwera NPI można dołączyć tylko do modułów dostawcy zarejestrowanych jako dostawcy tego samego serwera NPI. Podobnie moduł dostawcy zarejestrowany jako dostawca określonego serwera NPI może być dołączony tylko do modułów klienta zarejestrowanych jako klienci tego samego serwera NPI.

Każdy NPI definiuje następujące elementy:

• Identyfikator NPI , który jednoznacznie identyfikuje NPI. Moduł sieciowy określa identyfikator NPI wskazujący konkretny NPI, który obsługuje, gdy moduł sieciowy rejestruje się u Rejestratora Modułów Sieciowych (NMR). Moduł sieciowy może obsługiwać wiele NPI, rejestrując się w NMR wielokrotnie, raz dla każdego obsługiwanego NPI. Moduł NMR zainicjuje dołączanie modułu klienta do modułu dostawcy tylko wtedy, gdy oba obsługują ten sam NPI.

• Opcjonalna struktura charakterystyki klienta, która określa cechy specyficzne dla NPI każdego modułu klienta. Takie cechy specyficzne dla interfejsu NPI mogą zawierać elementy, takie jak wersja (lub wersje) serwera NPI obsługiwanego przez moduł klienta lub rodzina adresów lub protokół wymagany przez moduł klienta. Moduł dostawcy może używać informacji zawartych w strukturze cech modułu klienta, aby określić, czy połączy się z modułem klienta. Jeśli serwer NPI nie definiuje żadnych cech klienta specyficznych dla serwera NPI, ta struktura nie jest wymagana.

• Opcjonalne cechy charakterystyczne struktury, które określają cechy specyficzne dla dostawcy NPI każdego modułu dostawcy. Takie cechy specyficzne dla interfejsu NPI mogą obejmować elementy, takie jak wersja (lub wersje) NPI obsługiwana przez moduł dostawcy, lub rodziny adresów czy protokoły, które obsługuje moduł dostawcy. Moduł klienta może używać informacji zawartych w strukturze cech klienta modułu dostawcy, aby określić, czy zostanie on dołączony do modułu dostawcy. Jeśli serwer NPI nie definiuje żadnych cech dostawcy specyficznych dla serwera NPI, ta struktura nie jest wymagana.

• Zero albo więcej funkcji wywołań zwrotnych modułu klienta. Po pomyślnym dołączeniu modułu dostawcy do modułu klienta moduł dostawcy może uzyskać dostęp do funkcji modułu klienta przez wywołanie funkcji wywołania zwrotnego modułu klienta.

• Co najmniej jedna funkcja modułu dostawcy. Po pomyślnym dołączeniu modułu klienta do modułu dostawcy moduł klienta może uzyskać dostęp do funkcji modułu dostawcy przez wywołanie funkcji modułu dostawcy.

• Struktura tabeli dystrybucji klienta , która zawiera wskaźniki funkcji do każdej funkcji wywołania zwrotnego modułu klienta. Jeśli NPI nie definiuje żadnych funkcji wywołania zwrotnego modułu klienta, ta struktura nie jest wymagana.

• Struktura tabeli wysyłania dostawcy zawierająca wskaźniki funkcji do każdej funkcji modułu dostawcy.

Moduł klienta obsługujący określone NPI używa elementów zdefiniowanych przez NPI do zaimplementowania interfejsu po stronie klienta. Podobnie moduł dostawcy obsługujący określony serwer NPI używa elementów zdefiniowanych przez serwer NPI do implementowania strony dostawcy interfejsu.

Wszystkie elementy zdefiniowane przez serwer NPI są nieprzezroczyste dla nmR z wyjątkiem identyfikatora NPI. Moduł NMR używa identyfikatora NPI, aby określić, które moduły klienta powinny być dołączone do modułów dostawcy.