NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES
Le pilote miniport émet une indication NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status lorsque ses fonctionnalités de filtrage de réception actuellement activées changent.
Note Cette status indication ne doit être effectuée que par les pilotes miniports qui prennent en charge les filtres de réception NDIS.
Lorsque le pilote miniport effectue cette indication status, 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.
Notes
Les filtres de réception NDIS sont utilisés dans les interfaces NDIS suivantes :
NDIS Packet Coalescing. Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Gestion des filtres de réception de coalescing de paquets.
Virtualisation d’E/S racine unique (SR-IOV). Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Définition d’un filtre de réception sur un port virtuel.
Virtual Machine Queue (VMQ). Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Définition et suppression des filtres VMQ.
Le pilote miniport émet l’indication NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status 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 via 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 qui appartiennent à 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 MUX NDIS.
Le pilote miniport effectue les étapes suivantes lorsqu’il émet l’indication NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status :
Le 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 de l’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Le pilote miniport définit le membre Révision de l’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 status de la manière 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 avoir la valeur
sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES).
Le pilote miniport émet l’indication status en appelant NdisMIndicateStatusEx. Le pilote doit passer un pointeur vers la structure NDIS_STATUS_INDICATION vers le paramètre StatusIndication .
Note Les pilotes sur-ment peuvent utiliser l’indication NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status 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.
Spécifications
Version |
Pris en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ndis.h (inclure Ndis.h) |