Compartilhar via


Requisitos do INF para extensões de comutador extensível do Hyper-V

As extensões de comutador extensível do Hyper-V são desenvolvidas como drivers de filtro NDIS. Como resultado, os requisitos inf para extensões são baseados nos requisitos inf para todos os drivers de filtro NDIS. Ao criar um arquivo INF para uma extensão de comutador extensível, você deve usar as configurações de INF para um driver de filtro de modificação ou monitoramento. Para obter mais informações sobre essas configurações, consulte Configurações de arquivo INF para drivers de filtro.

Além disso, você deve seguir estas diretrizes para arquivos INF para extensões de comutador extensíveis:

  • Uma extensão de comutador extensível deve ser instalada como um driver de filtro de modificação.

    Para obter mais informações sobre os requisitos do INF para um driver de filtro de modificação, consulte Configurando um arquivo INF para um driver de filtro de modificação.

    Nota Uma extensão com uma classe de filtro de ms_switch_capture pode executar as mesmas tarefas que um driver de filtro de monitoramento. Para obter mais informações, consulte Tipos de drivers de filtro.

  • A entrada FilterMediaTypes no arquivo INF de filtro define as associações do driver para outros drivers e interfaces. A entrada FilterMediaTypes para uma extensão de comutador extensível deve incluir o valor de vmnetextension . Esse valor especifica uma associação ao adaptador de miniporta de extensão de comutador extensível.

    A entrada FilterMediaTypes permite que uma lista delimitada por vírgulas de tipos de mídia seja especificada. Isso permite que a extensão seja associada a uma interface física ou à interface de comutador extensível.

    O exemplo a seguir mostra uma entrada FilterMediaTypes que permite que uma extensão seja associada ao adaptador de rede Ethernet físico ou a um adaptador de rede virtual comutador extensível.

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

    Se a entrada FilterMediaTypes especificar apenas o valor vmnetextension , a extensão só será associada às pilhas de driver para todos os comutadores extensíveis no sistema.

    Se a entrada FilterMediaTypesespecificar vmnetextension , bem como outros tipos de mídia, a extensão poderá determinar se ela está associada a uma pilha de driver de comutador extensível chamando NdisFGetOptionalSwitchHandlers. Se a função retornar NDIS_STATUS_SUCCESS, a extensão será associada dentro da pilha do driver de extensão. Se a função retornar NDIS_STATUS_NOT_SUPPORTED, a extensão será associada dentro da pilha de driver para um adaptador de rede físico diferente.

    Para obter mais informações sobre a entrada FilterMediaTypes , consulte Entradas de arquivo INF de UpperRange e LowerRange do Driver Intermediário.

  • O valor FilterClass no arquivo INF de uma extensão determina sua ordem em uma pilha de filtros. A entrada FilterClass deve conter um dos valores da tabela a seguir.

    Valor de FilterClass Descrição

    ms_switch_capture

    Uma extensão dessa classe monitora o tráfego de pacotes. No entanto, essa classe de extensão não pode aplicar políticas de porta ou alterar portas de destino para um pacote.

    Para obter mais informações sobre essa classe de extensão, consulte Capturando extensões.

    ms_switch_filter

    Uma extensão dessa classe filtra o tráfego de pacotes e impõe a política de porta ou comutador para entrega de pacotes por meio do comutador extensível. Essa classe de driver também pode inspecionar e remover portas de destino para cada pacote com base nas configurações de política.

    Para obter mais informações sobre essa classe de extensão, consulte Filtrando extensões.

    ms_switch_forward

    Uma extensão dessa classe tem os mesmos recursos que a classe ms_switch_filter . Essa classe de extensão também pode encaminhar pacotes para outras portas de comutador extensíveis, bem como injetar tráfego de pacotes em qualquer porta de comutador extensível.

    No caminho de dados de entrada, essa classe de extensão é invocada após a classe de extensão ms_switch_filter . No caminho de dados de saída, essa classe de extensão é invocada antes da classe de extensão ms_switch_filter .

    Para obter mais informações sobre essa classe de extensão, consulte Extensões de encaminhamento.

    Nota Somente uma extensão dessa classe é permitida na pilha de driver de comutador extensível.

Quando a extensão for instalada com essas configurações de INF, ela será configurada para associar a cada instância de comutador extensível. No entanto, a associação será desabilitada e deverá ser habilitada explicitamente por meio de um cmdlet do PowerShell. Para obter mais informações sobre esse procedimento, consulte Habilitando extensões de comutador extensível do Hyper-V.