NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES
Le pilote miniport émet une indication d’état NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES lorsque ses fonctionnalités de filtrage actuellement activées changent.
Remarque Cette indication d’état ne doit être effectuée que par les pilotes miniport qui prennent en charge les filtres de réception NDIS.
Lorsque le pilote miniport affiche cette indication d’état, il définit le membre StatusBuffer de la structure NDIS_STATUS_INDICATION sur un pointeur vers une structure NDIS_RECEIVE_FILTER_CAPABILITIES. Le pilote initialise cette structure avec ses fonctionnalités de filtre de réception actuellement activées.
Remarques
Les filtres de réception NDIS sont utilisés dans les interfaces NDIS suivantes :
de fusion des paquets NDIS . Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Gestion des filtres de réception de fusion de paquets.
virtualisation d’E/S racine unique (SR-IOV). Pour plus d’informations sur l’utilisation de filtres de réception dans cette interface, consultez Définition d’un filtre de réception sur un port virtuel.
file d’attente de machines virtuelles (VMQ). Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Paramètre et effacement des filtres VMQ.
Le pilote miniport émet l’indication d’état NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES lorsque l’une des conditions suivantes est remplie :
Les fonctionnalités de filtre de réception actuellement activées changent sur une seule carte réseau. Par exemple, les filtres de réception peuvent être activés ou désactivés par le biais d’une application de gestion développée par le fournisseur de matériel indépendant (IHV).
Les fonctionnalités de filtre de réception actuellement activées changent pour une ou plusieurs cartes réseau appartenant à une équipe de basculement d’équilibrage de charge (LBFO) gérée par un pilote intermédiaire MUX. Pour plus d’informations, consultez pilotes intermédiaires NDIS MUX.
Le pilote miniport suit ces étapes lorsqu’il émet l’indication d’état NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES :
La miniport initialise la structure NDIS_RECEIVE_FILTER_CAPABILITIES avec les fonctionnalités de filtre de réception actuellement activées sur la carte réseau.
Lorsque le pilote miniport initialise le membre d’en-tête , il définit le membre Type d’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Le pilote miniport définit le membre révision de d’en-tête sur NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2 et le membre Size sur NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2.
Le pilote miniport initialise une structure NDIS_STATUS_INDICATION pour l’indication d’état de la façon suivante :
Le membre StatusCode doit être défini sur NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES.
Le membre StatusBuffer doit être défini sur l’adresse de la structure NDIS_RECEIVE_FILTER_CAPABILITIES.
Le membre StatusBufferSize doit être défini sur
sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES).
Le pilote miniport émet l’indication d’état en appelant NdisMIndicateStatusEx. Le pilote doit passer un pointeur à la structure NDIS_STATUS_INDICATION au paramètre StatusIndication.
Remarque les pilotes overlying peuvent utiliser l’indication d’état NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES pour déterminer les fonctionnalités de filtre de réception actuellement activées de la carte réseau. Ces pilotes peuvent également émettre des requêtes OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES pour obtenir les fonctionnalités de filtre de réception actuellement activées à tout moment.
Exigences
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ndis.h (include Ndis.h) |