Capturando extensões

Uma extensão de captura de switch extensível Hyper-V inspeciona o tráfego de pacotes, solicitações de identificador de objeto (OID) e indicações de status NDIS. Esse tipo de extensão não pode modificar ou descartar pacotes, ou excluir pacotes de serem entregues a portas de switch extensíveis. No entanto, a captura de extensões pode originar tráfego de pacotes, como pacotes que contêm estatísticas de tráfego que a extensão envia para um aplicativo host.

As extensões de captura são invocadas no início do caminho de dados de entrada e no final do caminho de dados de saída. Para obter mais informações sobre esses caminhos de dados, consulte Hyper-V Caminho de Dados do Switch Extensível.

Uma extensão de captura tem os seguintes requisitos e restrições:

• Uma extensão de captura deve ser desenvolvida como um driver de filtro NDIS que suporte a interface de comutador extensível.

  Para obter mais informações sobre drivers de filtro, consulte NDIS Filter Drivers.

  Para mais informações sobre como escrever uma extensão para captura, consulte a seção Writing Hyper-V Extensible Switch Extensions.

• Uma extensão de captura fornece a mesma funcionalidade que um driver de filtro de monitoramento NDIS padrão. No entanto, o ficheiro INF para uma extensão de captura deve instalá-lo como um driver de filtro modificador.

  Para obter mais informações sobre como modificar drivers de filtro, consulte Tipos de drivers de filtro.

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

• Uma extensão de captura pode monitorar pacotes pelo caminho de dados do switch extensível de entrada e saída. No entanto, esse tipo de extensão sempre deve chamar NdisFSendNetBufferLists para encaminhar os pacotes para drivers subjacentes na pilha de driver de switch extensível e não completá-los.

• Uma extensão de captura não deve modificar os dados dentro dos pacotes nem adicionar destinos de porta aos dados fora de banda (OOB) do pacote. A extensão não deve isentar a entrega do pacote a nenhuma porta de switch extensível.

• Uma extensão de captura pode originar pacotes. Por exemplo, a extensão pode originar pacotes para relatar condições de tráfego para um aplicativo de monitoramento remoto.

  Para obter mais informações sobre como originar pacotes por uma extensão, consulte Originando o tráfego de pacotes.

  Nota Tal como acontece com outras extensões, a extensão de captura só pode originar tráfego de pacotes no caminho de dados de entrada do comutador extensível.

• Uma extensão de captura pode monitorizar pacotes, solicitações OID e indicações de estado NDIS emitidas sobre a pilha de driver de switch extensível. No entanto, este tipo de extensão deve encaminhar pacotes, solicitações OID e indicações de status NDIS através da pilha de drivers do switch extensível. A extensão não deve modificar os dados dentro dos pacotes, solicitações OID ou indicações de status NDIS que monitora.

• O valor FilterClass no arquivo INF para a extensão deve ser definido como ms_switch_capture. Para mais informações, consulte Requisitos INF para Extensões de Switch Extensível Hyper-V.

• Qualquer número de extensões de captura pode ser associado a uma instância de comutador extensível. Por padrão, várias extensões de captura são ordenadas com base em quando foram instaladas. Por exemplo, várias extensões de captura são dispostas em camadas na pilha de drivers de switch extensíveis, com a extensão instalada mais recentemente posicionada acima das outras extensões de captura na pilha.

  Depois de vinculado a uma instância de switch extensível, a ordenação das camadas das extensões de captura na pilha de drivers do switch extensível pode ser alterada. Para obter mais informações, consulte reordenando Hyper-V extensões extensíveis de switch.