Partager via


Inscription aux notifications de carte réseau SAN

Lorsqu’un pilote proxy reçoit une demande de son fournisseur de services SAN associé pour fournir la liste des adresses IP affectées aux cartes réseau sous le contrôle du pilote, le pilote détermine et transmet cette liste au fournisseur.

Pour obtenir ces adresses IP, le pilote proxy doit s’inscrire auprès de l’interface TDI (Transport Driver Interface) pour recevoir des notifications de modification d’adresse. Le pilote proxy appelle la fonction TdiRegisterPnPHandlers . Dans cet appel, ce pilote proxy passe des pointeurs vers des fonctions de rappel dans les membres AddAddressHandlerV2 et DelAddressHandlerV2 de la structure TDI_CLIENT_INTERFACE_INFO pour spécifier des fonctions de rappel pour les ajouts et les suppressions d’adresses. Une fois la fonction TdiRegisterPnPHandlers retournée avec succès, TDI indique immédiatement toutes les adresses réseau actuellement actives au pilote proxy, à l’aide du rappel d’ajout d’adresses. L’indication contient à la fois les adresses réseau et les identificateurs des appareils auxquels ces adresses sont liées.

Chaque fois que TDI appelle l’une de ces fonctions de rappel pour indiquer des ajouts ou des suppressions d’adresses, le pilote proxy nécessite les paramètres suivants :

Adresse
Pointeur vers une structure de TA_ADDRESS qui décrit l’adresse réseau affectée ou supprimée de la carte réseau. Dans le cas de TCP/IP, ce pointeur est en fait un pointeur vers une structure TA_ADDRESS_IP.

DeviceName
Pointeur vers une chaîne Unicode qui identifie la liaison de transport vers la carte réseau à laquelle l’adresse est associée. Dans le cas de TCP/IP, la chaîne Unicode a le format suivant : \Device\Tcpip_{NIC-GUID}, où NIC-GUID est l’identificateur global unique affecté par le sous-système de configuration réseau à la carte réseau.

Les définitions de structure précédentes sont définies dans le fichier d’en-tête tdi.h. Les fonctions d’inscription et de rappel précédentes sont définies dans le fichier d’en-tête tdikrnl.h. Ces fichiers d’en-tête sont disponibles dans le Kit de développement de pilotes Microsoft Windows (DDK) et le Kit de pilotes Windows (WDK). Pour plus d’informations sur les notifications TDI Plug-and-Play (PnP), consultez Rappels de client TDI et Événements de client TDI et Gestionnaires de notification PnP.

Au démarrage du système, TDI appelle le rappel d’ajout d’adresses du pilote proxy pour indiquer toutes les adresses IP actuellement actives. TDI appelle également ce rappel chaque fois que le protocole de transport TCP/IP enregistre une nouvelle adresse IP auprès de TDI. Le pilote de proxy inclut dans sa liste d’adresses IP uniquement les adresses affectées aux cartes réseau du pilote proxy. Le rappel d’ajout d’adresse du pilote doit retourner rapidement le contrôle si le pilote ne reconnaît pas la carte réseau sur DeviceName.

TDI appelle le rappel de suppression d’adresse du pilote proxy chaque fois que le protocole de transport TCP/IP indique à TDI qu’une carte réseau a été supprimée. Si l’adresse IP de la carte réseau appartient à l’une des cartes réseau du pilote proxy, le pilote proxy supprime l’adresse IP de la liste.

Note TDI ne sera pas pris en charge dans les versions de Microsoft Windows après Windows Vista. Utilisez la plateforme de filtrage Windows ou le noyau Winsock à la place.