Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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. |