Wymagania INF dotyczące rozszerzalnych rozszerzeń przełącznika Hyper-V

Hyper-V rozszerzalne rozszerzenia przełącznika są opracowywane jako sterowniki filtrów NDIS. W związku z tym wymagania INF dla rozszerzeń są oparte na wymaganiach INF dla wszystkich sterowników filtrów NDIS. Podczas tworzenia pliku INF dla rozszerzalnego rozszerzenia przełącznika należy użyć ustawień INF do modyfikowania lub monitorowania sterownika filtru. Aby uzyskać więcej informacji na temat tych ustawień, zobacz ustawienia plików INF dla sterowników filtrów.

Ponadto należy postępować zgodnie z tymi wytycznymi dotyczącymi plików INF dla rozszerzalnych rozszerzeń przełączników:

• Rozszerzenie przełącznika rozszerzalnego musi być zainstalowane jako modyfikujący sterownik filtru.

  Aby uzyskać więcej informacji na temat wymagań INF dla sterownika filtrującego z funkcją modyfikacji, zobacz Konfigurowanie pliku INF dla sterownika filtrującego z funkcją modyfikacji.

  Note An extension with a filter class of ms_switch_capture can perform the same tasks as a monitoring filter driver. Aby uzyskać więcej informacji, zobacz Typy sterowników filtrów.

• 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. Ta wartość określa powiązanie z kartą miniport adaptacyjną rozszerzenia elastycznego przełącznika.

  The FilterMediaTypes entry allows a comma-delimited list of media types to be specified. Dzięki temu rozszerzenie może być powiązane z interfejsem fizycznym lub z rozszerzalnym interfejsem przełącznika.

  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. Jeśli funkcja zwróci NDIS_STATUS_SUCCESS, rozszerzenie jest zintegrowane w ramach stosu sterownika rozszerzenia. Jeśli funkcja zwróci NDIS_STATUS_NOT_SUPPORTED, rozszerzenie jest zintegrowane w stosie sterowników dla innego fizycznego interfejsu sieciowego.

  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	Rozszerzenie tej klasy monitoruje ruch pakietów. Jednak ta klasa rozszerzenia nie może stosować zasad portów ani zmieniać portów docelowych dla pakietu. For more information about this class of extension, see Capturing Extensions.
  ms_switch_filter	Rozszerzenie tej klasy filtruje ruch pakietów i wymusza zasady dotyczące portu lub przełącznika w zakresie dostarczania pakietów za pośrednictwem przełącznika rozszerzalnego. Ta klasa sterownika może również sprawdzać i usuwać porty docelowe dla każdego pakietu na podstawie ustawień zasad. 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. Ta klasa rozszerzenia może również przekazywać pakiety do innych rozszerzalnych portów przełącznika, a także wprowadzać ruch pakietów do dowolnego rozszerzalnego portu przełącznika. 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.

Po zainstalowaniu rozszerzenia z tymi ustawieniami INF zostanie ono skonfigurowane tak, aby było powiązane z każdym rozszerzalnym wystąpieniem przełącznika. Jednak powiązanie zostanie wyłączone i musi być jawnie włączone za pomocą polecenia cmdlet programu PowerShell. Aby uzyskać więcej informacji na temat tej procedury, zobacz Włączanie rozszerzalnych rozszerzeń przełącznika Hyper-V.