Extensions de capture

Une extension de capture de commutateur extensible Hyper-V inspecte le trafic de paquets, les requêtes d’identificateur d’objet (OID) et les indications d’état NDIS. Ce type d’extension ne peut pas modifier ou supprimer des paquets, ou exclure les paquets d’être remis aux ports de commutateur extensibles. Toutefois, la capture d’extensions peut provenir du trafic de paquets, comme les paquets qui contiennent des statistiques de trafic envoyées par l’extension à une application hôte.

Les extensions de capture sont appelées au début du chemin de données d’entrée et à la fin du chemin de données de sortie. Pour plus d’informations sur ces chemins de données, consultez Hyper-V chemin de données de commutateur extensible.

Une extension de capture présente les exigences et restrictions suivantes :

• Une extension de capture doit être développée en tant que pilote de filtre NDIS qui prend en charge l’interface de commutateur extensible.

  Pour plus d’informations sur les pilotes de filtre, consultez Pilotes de filtre NDIS.

  Pour plus d’informations sur la façon d’écrire une extension de capture, consultez Écriture des extensions de commutateurs extensibles Hyper-V.

• Une extension de capture fournit les mêmes fonctionnalités qu’un pilote de filtre de surveillance NDIS standard. Toutefois, le fichier INF d’une extension de capture doit l’installer en tant que pilote de filtre de modification.

  Pour plus d’informations sur la modification des pilotes de filtre, consultez Types de pilotes de filtre.

  Pour plus d’informations sur les exigences INF pour la modification des pilotes de filtre, consultez Configuration d’un fichier INF pour un pilote de filtre modificateur.

• Une extension de capture peut surveiller les paquets sur le flux entrant et sortant du chemin de données du commutateur extensible. Toutefois, ce type d’extension doit toujours appeler NdisFSendNetBufferLists pour transférer les paquets aux pilotes sous-jacents dans la pile de pilotes de commutateur extensible et ne pas les terminer.

• Une extension de capture ne doit pas modifier les données dans les paquets ni ajouter des destinations de port aux données OOB (out-of-band) du paquet. L’extension ne doit pas exempter la remise du paquet à un port de commutateur extensible.

• Une extension de capture peut générer des paquets. Par exemple, l’extension peut générer des paquets afin de signaler les conditions de trafic à une application de supervision à distance.

  Pour plus d’informations sur la création de paquets par une extension, consultez Création d’un trafic de paquets.

  Remarque Comme avec d’autres extensions, l’extension de capture ne peut provenir que du trafic de paquets dans le chemin de données d’entrée extensible du commutateur.

• Une extension de capture peut surveiller les paquets, les demandes OID et les indications d’état NDIS émises sur la pile de pilotes de commutateur extensible. Toutefois, ce type d’extension doit transférer des paquets, des demandes OID et des indications d’état NDIS via la pile de pilotes de commutateur extensible. L’extension ne doit pas modifier les données dans les paquets, les demandes OID ou les indications d’état NDIS qu’elle surveille.

• La valeur FilterClass dans le fichier INF de l’extension doit être définie sur ms_switch_capture. Pour plus d’informations, consultez Configuration INF requise pour les extensions de commutateurs extensibles Hyper-V.

• Un nombre quelconque d’extensions de capture peut être lié à une instance de commutateur extensible. Par défaut, plusieurs extensions de capture sont classées en fonction de la date de leur installation. Par exemple, plusieurs extensions de capture sont empilées dans la pile de pilotes pour commutateur extensible, avec l'extension la plus récemment installée placée au sommet des autres extensions de capture dans la pile.

  Une fois lié à une instance de commutateur extensible, la superposition des extensions de capture dans la pile de pilotes de commutateur extensible peut être réorganisée. Pour plus d’informations, consultez Réorganisation des extensions de commutateurs extensibles Hyper-V.