Conditions requises pour les extensions de commutateur extensible Hyper-V

Hyper-V extensions de commutateur extensible 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 d’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 extensible :

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

  Pour plus d’informations sur les exigences inf pour un pilote de filtre de modification, consultez Configuration d’un fichier INF pour un pilote de filtre de modification.

  Note An extension with a filter class of ms_switch_capture can perform the same tasks as a monitoring filter driver. Pour plus d’informations, consultez Types de pilotes de filtre.

• The FilterMediaTypes entry in the filter INF file defines the driver's bindings to other drivers and interfaces. The FilterMediaTypes entry for an extensible switch extension must include the vmnetextension value. Cette valeur spécifie une liaison à l’adaptateur miniport d’extension de commutateur extensible.

  The FilterMediaTypes entry allows a comma-delimited list of media types to be specified. Cela permet à l’extension d’être liée à une interface physique ou à l’interface de commutateur extensible.

  The following example shows a FilterMediaTypes entry that allows an extension to be bound to either the physical Ethernet network adapter or an extensible switch virtual network adapter.

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

  If the FilterMediaTypes entry only specifies the vmnetextension value, the extension will only bind to the driver stacks for all extensible switches on the system.

  If the FilterMediaTypes entry specifies vmnetextension as well as other media types, the extension can determine whether it is bound within an extensible switch driver stack by calling 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 des pilotes pour une autre interface réseau physique.

  For more information about the FilterMediaTypes entry, see Intermediate Driver UpperRange And LowerRange INF File Entries.

• The FilterClass value in the INF file for an extension determines its order in a stack of filters. The FilterClass entry must contain one of the values from the following table.

  FilterClass value	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. For more information about this class of extension, see Capturing Extensions.
  ms_switch_filter	Une extension de cette classe filtre le trafic de paquets et applique la 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 des ports de destination pour chaque paquet en fonction des paramètres de stratégie. For more information about this class of extension, see Filtering Extensions.
  ms_switch_forward	An extension of this class has the same capabilities as the ms_switch_filter class. Cette classe d’extension peut également transférer des paquets vers d’autres ports de commutateur extensible, ainsi qu’injecter le trafic de paquets vers n’importe quel port de commutateur extensible. On the ingress data path, this class of extension is invoked after the ms_switch_filter class of extension. On the egress data path, this class of extension is invoked before the ms_switch_filter class of extension. For more information about this class of extension, see Forwarding Extensions. Note Only one extension of this class is allowed in the extensible switch driver stack.

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