Partager via


Vue d’ensemble de l’assistance IP

Internet Protocol Helper (IP Helper) permet aux pilotes de récupérer des informations sur la configuration réseau de l’ordinateur local et de modifier cette configuration. L’assistance IP fournit également des mécanismes de notification pour s’assurer qu’un pilote est averti lorsque certains aspects de la configuration du réseau de l’ordinateur local changent. L’assistance IP est disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Microsoft Windows.

De nombreuses fonctions IP Helper transmettent des paramètres de structure qui représentent des types de données associés à la technologie MIB (Management Information Base). Les fonctions d’assistance IP utilisent ces structures MIB pour représenter diverses informations réseau.

La documentation de l’assistance IP utilise largement les termes adaptateur et interface. Un adaptateur est un terme hérité qui est l'abréviation de adaptateur réseau, qui faisait initialement référence à une forme de matériel réseau. Un adaptateur est une abstraction au niveau des liens de données.

Une interface est décrite dans les documents RFC IETF en tant que concept abstrait qui représente la pièce jointe d’un nœud à un lien. Une interface est une abstraction au niveau IP.

Votre pilote peut utiliser les fonctions en mode noyau, les structures MIB et les énumérations MIB et de couche réseau (NL) suivantes pour récupérer et modifier les paramètres de configuration pour le transport TCP/IP (Transmission Control Protocol) sur un ordinateur local.

Remarque

Lorsque vous développez du code de pilote, suivez les instructions pour , y compris les fichiers d'en-tête.

Fonctions de conversion d’interface

Fonction Description
ConvertInterfaceAliasToLuid Convertit un identificateur unique localement (LUID) pour une interface réseau en nom d’interface Unicode.
ConvertInterfaceGuidToLuid Convertit un identificateur global unique (GUID) pour une interface réseau en LUID pour l’interface.
ConvertInterfaceIndexToLuid Convertit un index local pour une interface réseau en LUID pour l’interface.
ConvertInterfaceLuidToAlias Convertit un LUID pour une interface réseau en alias d’interface.
ConvertInterfaceLuidToGuid Convertit un LUID pour une interface réseau en GUID pour l’interface.
ConvertInterfaceLuidToIndex Convertit un LUID pour une interface réseau en index local de l’interface.
ConvertInterfaceLuidToNameA Convertit un LUID pour une interface réseau en nom d’interface ANSI.
ConvertInterfaceLuidToNameW Convertit un LUID pour une interface réseau en nom d’interface Unicode.
ConvertInterfaceNameToLuidA Convertit un nom d’interface réseau ANSI en LUID pour l’interface.
ConvertInterfaceNameToLuidW Convertit un nom d’interface réseau Unicode en LUID pour l’interface.
if_indextoname Convertit l’index local d’une interface réseau en nom d’interface ANSI.
if_nametoindex Convertit le nom de l’interface ANSI d’une interface réseau en index local de l’interface.

Fonctions de gestion des interfaces

Fonction Description
GetIfEntry2 Récupère des informations pour l’interface spécifiée sur l’ordinateur local.
GetIfStackTable Récupère une table d'entrées de ligne de pile d'interface réseau qui spécifie la relation des interfaces réseau sur une pile d'interface.
GetIfTable2 Récupère la table d’interface MIB-II.
GetIfTable2Ex Récupère la table d’interface MIB-II, en fonction d’un niveau d’informations d’interface à récupérer.
GetInvertedIfStackTable Récupère une table contenant les entrées de ligne inversées de la pile d'interfaces réseau qui spécifient la relation entre les interfaces réseau sur une pile d'interfaces.
GetIpInterfaceEntry Récupère les informations IP de l’interface spécifiée sur l’ordinateur local.
GetIpInterfaceTable Récupère les entrées d’interface IP sur l’ordinateur local.
InitializeIpInterfaceEntry Initialise les membres d’une entrée de structure MIB_IPINTERFACE_ROW avec des valeurs par défaut.
SetIpInterfaceEntry Définit les propriétés d’une interface IP sur l’ordinateur local.

Fonctions de gestion des adresses IP

Fonction Description
CreateAnycastIpAddressEntry Ajoute une nouvelle entrée d’adresse IP anycast sur l’ordinateur local.
CreateSortedAddressPairs Associe une liste fournie d’adresses de destination avec les adresses IP locales de l’ordinateur hôte et trie les paires en fonction de l’ordre de communication préféré.
CreateUnicastIpAddressEntry Ajoute une nouvelle entrée d'adresse IP de monodiffusion sur l'ordinateur local.
DeleteAnycastIpAddressEntry Supprime une entrée d’adresse IP anycast existante de l’ordinateur local.
DeleteUnicastIpAddressEntry Supprime une entrée d'adresse IP de monodiffusion existante sur l'ordinateur local.
GetAnycastIpAddressEntry Récupère des informations pour une entrée d’adresse IP anycast existante sur l’ordinateur local.
GetAnycastIpAddressTable Récupère la table d’adresses IP anycast sur l’ordinateur local.
GetMulticastIpAddressEntry Récupère les informations relatives à une entrée d'adresse IP multidiffusion existante sur l'ordinateur local.
GetMulticastIpAddressTable Récupère la table des adresses IP de multidiffusion sur l'ordinateur local.
GetUnicastIpAddressEntry Récupère les informations relatives à une entrée d'adresse IP unicast existante sur l'ordinateur local.
GetUnicastIpAddressTable Récupère la table d’adresses IP unicast sur l’ordinateur local.
InitializeUnicastIpAddressEntry Initialise une structure MIB_UNICASTIPADDRESS_ROW avec des valeurs par défaut pour une entrée d'adresse IP unicast sur l'ordinateur local.
NotifyStableUnicastIpAddressTable Récupère la table des adresses IP unicast stables sur un ordinateur local.
SetUnicastIpAddressEntry Définit les propriétés d’une entrée d’adresse IP unicast existante sur l’ordinateur local.

Fonctions de gestion des adresses du voisin IP

Fonction Description
CreateIpNetEntry2 Crée une nouvelle entrée d'adresse IP de voisinage sur l'ordinateur local.
DeleteIpNetEntry2 Supprime une entrée d’adresse IP voisine de l’ordinateur local.
FlushIpNetTable2 Vide la table des voisins IP sur l’ordinateur local.
GetIpNetEntry2 Récupère des informations pour une entrée d’adresse IP voisine sur l’ordinateur local.
GetIpNetTable2 Récupère la table des voisins IP de l’ordinateur local.
ResolveIpNetEntry2 Résout l’adresse physique d’une entrée d’adresse IP voisine sur l’ordinateur local.
SetIpNetEntry2 Définit l’adresse physique d’une entrée d’adresse IP voisine existante sur l’ordinateur local.

Fonctions de gestion des chemins d’accès IP

Fonction Description
FlushIpPathTable Vide la table de chemins d’accès IP sur l’ordinateur local.
GetIpPathEntry Récupère les informations relatives à une entrée de chemin IP sur l'ordinateur local.
GetIpPathTable Récupère des informations pour une table de chemins d’accès IP sur l’ordinateur local.

Fonctions de gestion des itinéraires IP

Fonction Description
CreateIpForwardEntry2 Crée une nouvelle entrée d'itinéraire IP sur l'ordinateur local.
DeleteIpForwardEntry2 Supprime une entrée d’itinéraire IP de l’ordinateur local.
GetBestRoute2 Récupère l’entrée d’itinéraire IP sur l’ordinateur local pour le meilleur itinéraire vers l’adresse IP de destination spécifiée.
GetIpForwardEntry2 Récupère des informations concernant une entrée d’itinéraire IP sur l’ordinateur local.
GetIpForwardTable2 Récupère les entrées d’itinéraire IP sur l’ordinateur local.
InitializeIpForwardEntry Initialise une structure MIB_IPFORWARD_ROW2 avec des valeurs par défaut pour une entrée d’itinéraire IP sur l’ordinateur local.
SetIpForwardEntry2 Définit les propriétés d’une entrée d’itinéraire IP sur l’ordinateur local.

Fonctions de gestion de la mémoire de table IP

Fonction Description
FreeMibTable Libère la mémoire tampon allouée par les fonctions qui retournent des tables d’interfaces réseau, d’adresses et d’itinéraires (par exemple, GetIfTable2 et GetAnycastIpAddressTable).

Fonctions de notification

Fonction Description
CancelMibChangeNotify2 Désenregistre le pilote pour les notifications de changement d'interface IP, d'adresse IP, d'itinéraire IP et les requêtes de récupération de la table stable d'adresses IP unicast.
NotifyIpInterfaceChange Inscrit le pilote pour être informé des modifications apportées à toutes les interfaces IP, interfaces IPv4 ou interfaces IPv6 sur un ordinateur local.
NotifyRouteChange2 S'inscrit pour être notifié des modifications apportées aux entrées d'itinéraires IP sur un ordinateur local.
NotifyUnicastIpAddressChange Enregistrements à notifier en cas de modification de toutes les interfaces IP de monodiffusion, des adresses IPv4 de monodiffusion ou des adresses IPv6 de monodiffusion sur un ordinateur local.

Fonctions de gestion des clients IPv6 Teredo

Fonction Description
GetTeredoPort Récupère le numéro de port UDP dynamique utilisé par le client Teredo sur l’ordinateur local.
NotifyTeredoPortChange S’inscrit à être informé des modifications apportées au numéro de port UDP que le client Teredo utilise pour le port du service Teredo sur un ordinateur local.
NotifyStableUnicastIpAddressTable Récupère sur un ordinateur local la table des adresses IP unicast stables.

Structures MIB

Structure Description
IP_ADDRESS_PREFIX Stocke un préfixe d’adresse IP.
MIB_ANYCASTIPADDRESS_ROW Stocke des informations sur une adresse IP anycast.
MIB_ANYCASTIPADDRESS_TABLE Contient une table d'entrées d'adresses IP anycast.
MIB_IF_ROW2 Stocke des informations sur une interface particulière.
MIB_IF_TABLE2 Contient une table des entrées d’interface logique et physique.
MIB_IFSTACK_ROW Représente la relation entre deux interfaces réseau.
MIB_IFSTACK_TABLE Contient une table d'entrées de lignes dans la pile d'interfaces réseau. Ce tableau spécifie la relation des interfaces réseau sur une pile d’interfaces.
MIB_INVERTEDIFSTACK_ROW Représente la relation entre deux interfaces réseau.
MIB_INVERTEDIFSTACK_TABLE Contient une table des entrées de ligne de la pile d'interface réseau inversée. Ce tableau spécifie la relation des interfaces réseau sur une pile d’interfaces dans l’ordre inverse.
MIB_IPFORWARD_ROW2 Stocke des informations sur une entrée d’itinéraire IP.
MIB_IPFORWARD_TABLE2 Contient une table des entrées d’itinéraire IP.
MIB_IPINTERFACE_ROW Stocke les informations de gestion des interfaces pour une famille d’adresses IP particulière sur une interface réseau.
MIB_IPINTERFACE_TABLE Contient une table des entrées d’interface IP.
MIB_IPNET_ROW2 Stocke des informations sur une adresse IP voisine.
MIB_IPNET_TABLE2 Contient une table des entrées d’adresse IP voisines.
MIB_IPPATH_ROW Stocke des informations sur une entrée de chemin d’accès IP.
MIB_IPPATH_TABLE Contient une table des entrées de chemin d’accès IP.
MIB_MULTICASTIPADDRESS_ROW Stocke des informations sur une adresse IP multidiffusion.
MIB_MULTICASTIPADDRESS_TABLE Contient une table d'entrées d'adresses IP multidiffusion.
MIB_UNICASTIPADDRESS_ROW Stocke des informations sur une adresse IP unicast.
MIB_UNICASTIPADDRESS_TABLE Contient une table d'entrées d'adresses IP unicast.

Enumérations MIB

Énumération Description
MIB_IF_TABLE_LEVEL Définit le niveau d’informations d’interface à récupérer.
MIB_NOTIFICATION_TYPE Définit le type de notification passé à une fonction de rappel lorsqu’une notification se produit.

Enumérations NL

Énumération Description
NL_ADDRESS_TYPE Spécifie le type d’adresse IP de la couche réseau.
NL_DAD_STATE Définit l'état de la détection des adresses dupliquées (DAD).
NL_LINK_LOCAL_ADDRESS_BEHAVIOR Définit le comportement d’adresse locale du lien.
NL_NEIGHBOR_STATE Définit l’état d’une adresse IP voisine de couche réseau, comme décrit dans RFC 2461, section 7.3.2.
NL_PREFIX_ORIGIN Définit l’origine du préfixe ou de la partie réseau de l’adresse IP.
NL_ROUTE_ORIGIN Définit l’origine de l’itinéraire IP.
NL_ROUTE_PROTOCOL Définit le mécanisme de routage avec lequel un itinéraire IP a été ajouté, comme décrit dans RFC 4292.
NL_ROUTER_DISCOVERY_BEHAVIOR Définit le comportement de découverte du routeur, comme décrit dans RFC 2461.
NL_SUFFIX_ORIGIN Définit l’origine du suffixe ou de la partie hôte de l’adresse IP.