Требования INF для расширений расширяемого коммутатора Hyper-V

Hyper-V расширения расширяемого коммутатора разрабатываются как драйверы фильтров NDIS. В результате требования INF для расширений основаны на требованиях INF для всех драйверов фильтров NDIS. При создании INF-файла для расширения расширяемого коммутатора следует использовать параметры INF для изменения или мониторинга драйвера фильтра. Дополнительные сведения об этих параметрах см. раздел Параметры INF-файла для драйверов фильтров.

Кроме того, необходимо следовать этим рекомендациям для INF-файлов для расширений расширяемого коммутатора:

  • Расширение расширяемого коммутатора должно быть установлено в качестве драйвера для изменения фильтра.

    Дополнительные сведения об INF-требованиях для драйвера модифицирующего фильтра см. в разделе Настройка INF-файла длядрайвера модифицирующего фильтра.

    Note An extension with a filter class of ms_switch_capture can perform the same tasks as a monitoring filter driver. Дополнительные сведения можно найти в разделе Типы драйверов фильтров.

  • 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. Это значение указывает привязку к минипорт-адаптеру расширяемого коммутатора.

    The FilterMediaTypes entry allows a comma-delimited list of media types to be specified. Это позволяет привязать расширение к физическому интерфейсу или расширяемому интерфейсу коммутатора.

    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. Если функция возвращает NDIS_STATUS_SUCCESS, расширение привязано к стеку драйверов расширения. Если функция возвращает NDIS_STATUS_NOT_SUPPORTED, расширение привязано в стеке драйверов для другого физического сетевого интерфейса.

    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

    Расширение этого класса отслеживает трафик пакетов. Однако этот класс расширения не может применять политики портов или изменять порты назначения для пакета.

    For more information about this class of extension, see Capturing Extensions.

    ms_switch_filter

    Расширение этого класса фильтрует трафик пакетов и применяет политику порта или коммутатора для доставки пакетов через расширяемый коммутатор. Этот класс драйвера также может проверять и удалять порты назначения для каждого пакета на основе параметров политики.

    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. Этот класс расширения также может пересылать пакеты другим портам расширяемого коммутатора, а также внедрять трафик пакетов в любой расширяемый порт коммутатора.

    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.

Если расширение установлено с этими параметрами INF, оно будет настроено для привязки к каждому расширяемом экземпляру коммутатора. Однако привязка будет отключена и должна быть явно включена с помощью командлета PowerShell. Дополнительные сведения об этой процедуре см. в разделе Включение расширений Hyper-V расширяемого коммутатора.

  • Last updated on