Configuration inf requise pour les extensions de commutateur extensible Hyper-V

Les extensions de commutateur extensible Hyper-V sont développées en tant que pilotes de filtre NDIS. Par conséquent, les exigences INF pour les extensions sont basées sur les exigences INF pour tous les pilotes de filtre NDIS. Lorsque vous créez un fichier INF pour une extension de commutateur extensible, vous devez utiliser les paramètres INF pour un pilote de filtre de modification ou de surveillance. Pour plus d’informations sur ces paramètres, consultez Paramètres de fichier INF pour les pilotes de filtre.

En outre, vous devez suivre ces instructions pour les fichiers INF pour les extensions de commutateur extensibles :

• Une extension de commutateur extensible doit être installée en tant que pilote de filtre de modification.

  Pour plus d’informations sur la configuration inf requise pour un pilote de filtre de modification, consultez Configuration d’un fichier INF pour un pilote de filtre de modification.

  Note Une extension avec une classe de filtre de ms_switch_capture peut effectuer les mêmes tâches qu’un pilote de filtre de surveillance. Pour plus d’informations, consultez Types de pilotes de filtre.

• L’entrée FilterMediaTypes dans le fichier INF de filtre définit les liaisons du pilote avec d’autres pilotes et interfaces. L’entrée FilterMediaTypes pour une extension de commutateur extensible doit inclure la valeur vmnetextension . Cette valeur spécifie une liaison à l’adaptateur miniport d’extension de commutateur extensible.

  L’entrée FilterMediaTypes permet de spécifier une liste de types de médias délimités par des virgules. Cela permet à l’extension d’être liée à une interface physique ou à l’interface de commutateur extensible.

  L’exemple suivant montre une entrée FilterMediaTypes qui permet à une extension d’être liée à la carte réseau Ethernet physique ou à une carte réseau virtuelle de commutateur extensible.

  HKR, Ndi\Interfaces, FilterMediaTypes, , "ethernet, vmnetextension"
  

  Si l’entrée FilterMediaTypes spécifie uniquement la valeur vmnetextension , l’extension est liée uniquement aux piles de pilotes pour tous les commutateurs extensibles sur le système.

  Si l’entrée FilterMediaTypes spécifie vmnetextension ainsi que d’autres types de médias, l’extension peut déterminer si elle est liée dans une pile de pilotes de commutateur extensible en appelant NdisFGetOptionalSwitchHandlers. Si la fonction retourne NDIS_STATUS_SUCCESS, l’extension est liée dans la pile des pilotes d’extension. Si la fonction retourne NDIS_STATUS_NOT_SUPPORTED, l’extension est liée dans la pile de pilotes pour une autre interface réseau physique.

  Pour plus d’informations sur l’entrée FilterMediaTypes , consultez Intermediate Driver UpperRange and LowerRange INF File Entries.

• La valeur FilterClass dans le fichier INF d’une extension détermine son ordre dans une pile de filtres. L’entrée FilterClass doit contenir l’une des valeurs du tableau suivant.

  Valeur FilterClass	Description
  ms_switch_capture	Une extension de cette classe surveille le trafic de paquets. Toutefois, cette classe d’extension ne peut pas appliquer de stratégies de port ou modifier les ports de destination d’un paquet. Pour plus d’informations sur cette classe d’extension, consultez Capture d’extensions.
  ms_switch_filter	Une extension de cette classe filtre le trafic de paquets et applique une stratégie de port ou de commutateur pour la remise de paquets via le commutateur extensible. Cette classe de pilote peut également inspecter et supprimer les ports de destination pour chaque paquet en fonction des paramètres de stratégie. Pour plus d’informations sur cette classe d’extension, consultez Filtrage des extensions.
  ms_switch_forward	Une extension de cette classe a les mêmes fonctionnalités que la classe ms_switch_filter . Cette classe d’extension peut également transférer des paquets vers d’autres ports de commutateur extensibles, ainsi que injecter le trafic de paquets vers n’importe quel port de commutateur extensible. Sur le chemin des données d’entrée, cette classe d’extension est appelée après la classe ms_switch_filter d’extension. Sur le chemin d’accès aux données de sortie, cette classe d’extension est appelée avant la classe d’extension ms_switch_filter . Pour plus d’informations sur cette classe d’extension, consultez Transfert d’extensions. Note Une seule extension de cette classe est autorisée dans la pile de pilotes de commutateur extensible.

Lorsque l’extension est installée avec ces paramètres INF, elle est configurée pour être liée à chaque commutateur extensible instance. Toutefois, la liaison est désactivée et doit être activée explicitement via une applet de commande PowerShell. Pour plus d’informations sur cette procédure, consultez Activation des extensions de commutateur extensible Hyper-V.