Requisiti INF per le estensioni di commutatori estendibili Hyper-V

Le estensioni di commutatore estendibili Hyper-V vengono sviluppate come driver di filtro NDIS. Di conseguenza, i requisiti INF per le estensioni si basano sui requisiti INF per tutti i driver di filtro NDIS. Quando si crea un file INF per un'estensione di commutatore estendibile, è necessario usare le impostazioni INF per un driver di filtro di modifica o monitoraggio. Per altre informazioni su queste impostazioni, vedere Impostazioni file INF per i driver di filtro.

È inoltre necessario seguire queste linee guida per i file INF per le estensioni di commutatori estendibili:

• Un'estensione del commutatore estendibile deve essere installata come driver di filtro di modifica.

  Per altre informazioni sui requisiti INF per un driver di filtro di modifica, vedere Configurazione di un file INF per un driver di filtro di modifica.

  Nota Un'estensione con una classe di filtro di ms_switch_capture può eseguire le stesse attività di un driver di filtro di monitoraggio. Per altre informazioni, vedere Tipi di driver di filtro.

• La voce FilterMediaTypes nel file INF filtro definisce le associazioni del driver ad altri driver e interfacce. La voce FilterMediaTypes per un'estensione di commutatore estendibile deve includere il valore vmnetextension . Questo valore specifica un'associazione all'adattatore miniport dell'estensione del commutatore estendibile.

  La voce FilterMediaTypes consente di specificare un elenco delimitato da virgole di tipi multimediali. Ciò consente l'associazione dell'estensione a un'interfaccia fisica o all'interfaccia del commutatore estendibile.

  Nell'esempio seguente viene illustrata una voce FilterMediaTypes che consente l'associazione di un'estensione alla scheda di rete Ethernet fisica o a una scheda di rete virtuale di commutatore estendibile.

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

  Se la voce FilterMediaTypes specifica solo il valore vmnetextension , l'estensione verrà associata solo agli stack di driver per tutti gli commutatori estendibili nel sistema.

  Se la voce FilterMediaTypes specifica vmnetextension e altri tipi di supporti, l'estensione può determinare se è associata all'interno di uno stack di driver switch estendibile chiamando NdisFGetOptionalSwitchHandlers. Se la funzione restituisce NDIS_STATUS_SUCCESS, l'estensione è associata all'interno dello stack di driver di estensione. Se la funzione restituisce NDIS_STATUS_NOT_SUPPORTED, l'estensione è associata all'interno dello stack di driver per un'interfaccia di rete fisica diversa.

  Per altre informazioni sulla voce FilterMediaTypes , vedere Voci di file UpperRange e LowerRange INF intermedio.

• Il valore FilterClass nel file INF per un'estensione determina l'ordine in uno stack di filtri. La voce FilterClass deve contenere uno dei valori della tabella seguente.

  Valore FilterClass	Descrizione
  ms_switch_capture	Un'estensione di questa classe monitora il traffico dei pacchetti. Tuttavia, questa classe di estensione non può applicare criteri di porta o modificare le porte di destinazione per un pacchetto. Per altre informazioni su questa classe di estensione, vedere Acquisizione di estensioni.
  ms_switch_filter	Un'estensione di questa classe filtra il traffico dei pacchetti e applica i criteri di porta o switch per il recapito dei pacchetti tramite l'opzione estendibile. Questa classe di driver può anche controllare e rimuovere le porte di destinazione per ogni pacchetto in base alle impostazioni dei criteri. Per altre informazioni su questa classe di estensione, vedere Filtro estensioni.
  ms_switch_forward	Un'estensione di questa classe ha le stesse funzionalità della classe ms_switch_filter . Questa classe di estensione può anche inoltrare pacchetti ad altre porte di commutatore estendibili, nonché inserire il traffico di pacchetti a qualsiasi porta di commutatore estendibile. Nel percorso dati in ingresso viene richiamata questa classe di estensione dopo la classe ms_switch_filter di estensione. Nel percorso dati in uscita, questa classe di estensione viene richiamata prima della classe ms_switch_filter di estensione. Per altre informazioni su questa classe di estensione, vedere Inoltro di estensioni. Nota Solo un'estensione di questa classe è consentita nello stack di driver di commutatore estendibile.

Quando l'estensione viene installata con queste impostazioni INF, verrà configurata per l'associazione a ogni istanza di commutatore estendibile. Tuttavia, l'associazione verrà disabilitata e deve essere abilitata in modo esplicito tramite un cmdlet di PowerShell. Per altre informazioni su questa procedura, vedere Abilitazione delle estensioni di commutatori estendibili Hyper-V.