Captura de extensiones

Una extensión extensible de captura de conmutador de Hyper-V inspecciona el tráfico de paquetes, las solicitudes de identificador de objeto (OID) y las indicaciones de estado de NDIS. Este tipo de extensión no puede modificar ni quitar paquetes, ni excluir los paquetes de entregarse a puertos de conmutador extensibles. Sin embargo, la captura de extensiones puede originar el tráfico de paquetes, como paquetes que contienen estadísticas de tráfico que la extensión envía a una aplicación host.

Las extensiones de captura se invocan al principio de la ruta de acceso de datos de entrada y al final de la ruta de acceso de datos de salida. Para obtener más información sobre estas rutas de acceso de datos, consulte Ruta de acceso de datos de conmutador extensible de Hyper-V.

Una extensión de captura tiene los siguientes requisitos y restricciones:

• Una extensión de captura debe desarrollarse como un controlador de filtro NDIS que admita la interfaz de conmutador extensible.

  Para obtener más información sobre los controladores de filtro, consulte Controladores de filtro NDIS.

  Para obtener más información sobre cómo escribir una extensión de captura, consulte Escritura de extensiones de conmutador extensible de Hyper-V.

• Una extensión de captura proporciona la misma funcionalidad que un controlador de filtro de supervisión NDIS estándar. Sin embargo, el archivo INF para una extensión de captura debe instalarlo como controlador de filtro de modificación.

  Para obtener más información sobre cómo modificar controladores de filtro, vea Tipos de controladores de filtro.

  Para obtener más información sobre los requisitos inf para modificar los controladores de filtro, consulte Configuración de un archivo INF para un controlador de filtro de modificación.

• Una extensión de captura puede supervisar paquetes a través de la ruta de acceso de datos de conmutador extensible de entrada y salida. Sin embargo, este tipo de extensión siempre debe llamar a NdisFSendNetBufferLists para reenviar los paquetes a los controladores subyacentes en la pila de controladores de conmutador extensible y no completarlos.

• Una extensión de captura no debe modificar los datos dentro de los paquetes ni agregar destinos de puerto a los datos fuera de banda (OOB) del paquete. La extensión no debe excluir la entrega del paquete a ningún puerto de conmutador extensible.

• Una extensión de captura puede originar paquetes. Por ejemplo, la extensión puede originar paquetes para notificar las condiciones de tráfico a una aplicación de supervisión remota.

  Para obtener más información sobre cómo originar paquetes por una extensión, consulte Tráfico de paquetes de origen.

  Nota Al igual que con otras extensiones, la extensión de captura solo puede originar el tráfico de paquetes en la ruta de acceso de datos de entrada del conmutador extensible.

• Una extensión de captura puede supervisar paquetes, solicitudes de OID y indicaciones de estado de NDIS que se emiten a través de la pila de controladores de conmutador extensible. Sin embargo, este tipo de extensión debe reenviar paquetes, solicitudes de OID y indicaciones de estado de NDIS a través de la pila de controladores de conmutador extensible. La extensión no debe modificar los datos dentro de los paquetes, las solicitudes de OID o las indicaciones de estado de NDIS que supervisa.

• El valor FilterClass del archivo INF de la extensión debe establecerse en ms_switch_capture. Para obtener más información, vea Inf Requirements for Hyper-V Extensible Switch Extensions.

• Cualquier número de extensiones de captura se puede enlazar a una instancia de conmutador extensible. De forma predeterminada, se ordenan varias extensiones de captura en función de cuándo se instalaron. Por ejemplo, varias extensiones de captura se superponen en la pila de controladores de conmutador extensible con la extensión instalada más recientemente por encima de otras extensiones de captura de la pila.

  Una vez enlazada a una instancia de conmutador extensible, se puede reordenar la capa de extensiones de captura en la pila de controladores de conmutador extensible. Para obtener más información, vea Reordenar extensiones de conmutador extensible de Hyper-V.