Interface de programmation réseau

Une interface de programmation réseau ou NPI définit l’interface entre les modules réseau qui peuvent être attachés les uns aux autres. Un module client inscrit en tant que client d’un NPI particulier ne peut être attaché qu’aux modules fournisseurs inscrits en tant que fournisseurs du même NPI. De même, un module fournisseur inscrit en tant que fournisseur d’un NPI particulier ne peut être attaché qu’aux modules clients inscrits en tant que clients du même NPI.

Chaque NPI définit les éléments suivants :

• Identificateur NPI qui identifie de façon unique l’indicateur NPI. Un module réseau spécifie un identificateur NPI pour indiquer l’indicateur NPI particulier qu’il prend en charge lorsque le module réseau s’inscrit auprès du bureau d’enregistrement de modules réseau (NMR). Un module réseau peut prendre en charge plusieurs NPIs en s'enregistrant auprès de la NMR plusieurs fois, une fois pour chaque NPI qu'il prend en charge. La NMR lance l’attachement d’un module client à un module fournisseur uniquement s’ils prennent tous les deux en charge le même NPI.

• Structure de caractéristiques clientes facultatives qui spécifie les caractéristiques spécifiques à l’indicateur de performance réseau de chaque module client. Ces caractéristiques spécifiques à l’indicateur de performance réseau peuvent inclure des éléments tels que la version (ou les versions) de l’indicateur de performance réseau pris en charge par un module client, ou la famille d’adresses ou le protocole requis par un module client. Un module fournisseur peut utiliser les informations contenues dans la structure des caractéristiques clientes d’un module client pour déterminer s’il est attaché au module client. Si un NPI ne définit pas de caractéristiques client spécifiques à l’indicateur NPI, cette structure n’est pas nécessaire.

• Structure facultative des caractéristiques du fournisseur qui spécifie les caractéristiques spécifiques aux NPI de chaque module fournisseur. Ces caractéristiques propres à l'interface de programmation réseau peuvent inclure des éléments tels que la version (ou les versions) de l'interface de programmation réseau prise en charge par un module fournisseur, ou les familles d'adresses ou les protocoles qu'un module fournisseur prend en charge. Un module client peut utiliser les informations contenues dans la structure des caractéristiques client d’un module fournisseur pour déterminer s’il est attaché au module fournisseur. Si un NPI ne définit aucune caractéristique de fournisseur spécifique à un NPI, cette structure n’est pas nécessaire.

• Zéro ou plusieurs fonctions de rappel du module client. Une fois qu’un module fournisseur s’attache correctement à un module client, le module fournisseur peut accéder aux fonctionnalités du module client en appelant les fonctions de rappel du module client.

• Une ou plusieurs fonctions de module fournisseur. Une fois qu’un module client s’attache correctement à un module fournisseur, le module client peut accéder aux fonctionnalités du module fournisseur en appelant les fonctions du module fournisseur.

• Structure de table de distribution pour le client qui contient des pointeurs de fonction pour chacune des fonctions de rappel du module client. Si un NPI ne définit aucune fonction de rappel de module client, cette structure n’est pas nécessaire.

• Structure de table de répartition du fournisseur qui contient des pointeurs de fonction vers chacune des fonctions du module fournisseur.

Un module client qui prend en charge un NPI particulier utilise les éléments définis par le NPI pour implémenter la partie client de l’interface. De même, un module fournisseur qui prend en charge un NPI particulier utilise les éléments définis par le NPI pour implémenter le côté fournisseur de l’interface.

Tous les éléments définis par un NPI sont opaques au NMR, à l’exception de l’identificateur NPI. La NMR utilise l’identificateur NPI pour déterminer quels modules clients doivent être attachés aux modules fournisseurs.