Capture d’extensions

Une extension de capture de commutateur extensible Hyper-V inspecte le trafic de paquets, les demandes d’identificateur d’objet (OID) et les indications status 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, par exemple des paquets qui contiennent des statistiques de trafic que l’extension envoie à une application hôte.

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

Une extension de capture a 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 l’écriture d’une extension de capture, consultez Écriture d’extensions de commutateur extensible 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 de modification.

• Une extension de capture peut surveiller les paquets sur le chemin des données de commutateur extensibles d’entrée et de sortie. 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 de destinations de port aux données hors bande (OOB) du paquet. L’extension ne doit pas exempter la remise du paquet à un port de commutateur extensible.

• Une extension de capture peut provenir de paquets. Par exemple, l’extension peut provenir de paquets afin de signaler les conditions de trafic à une application de surveillance à distance.

  Pour plus d’informations sur l’origine des paquets par une extension, consultez Trafic de paquets d’origine.

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

• Une extension de capture peut surveiller les paquets, les requêtes OID et les indications NDIS status qui sont émises sur la pile de pilotes de commutateur extensible. Toutefois, ce type d’extension doit transférer les paquets, les requêtes OID et les indications NDIS status via la pile de pilotes de commutateur extensible. L’extension ne doit pas modifier les données dans les paquets, les requêtes OID ou NDIS status indications 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 Exigences INF pour les extensions de commutateur extensible Hyper-V.

• N’importe quel nombre d’extensions de capture peut être lié à un commutateur extensible instance. Par défaut, plusieurs extensions de capture sont classées en fonction du moment où elles ont été installées. Par exemple, plusieurs extensions de capture sont superposées dans la pile de pilotes de commutateur extensible avec l’extension la plus récemment installée au-dessus des autres extensions de capture dans la pile.

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