Indicateurs d’état du module de filtre

Les pilotes de filtre peuvent fournir une fonction FilterStatus que NDIS appelle lorsqu’un pilote sous-jacent signale l’état. Les pilotes de filtre peuvent également lancer des indications d’état.

La figure suivante illustre une indication d’état filtrée.

NDIS appelle la fonction FilterStatus d’un pilote de filtre, après qu’un pilote sous-jacent appelle une fonction d’indication d’état (NdisMIndicateStatusEx ou NdisFIndicateStatus). Pour plus d’informations sur la façon d’indiquer l’état d’un pilote miniport, consultez Indications d’état de l’adaptateur.

Un pilote de filtre appelle NdisFIndicateStatus dans sa fonction FilterStatus pour transmettre une indication d’état filtrée aux pilotes superposés. Un pilote de filtre peut filtrer les indications d’état (en n’appelant pas NdisFIndicateStatus) ou modifier l’état indiqué avant d’appeler NdisFIndicateStatus.

Pour initier les indications d’état, les pilotes de filtre appellent NdisFIndicateStatus sans appel préalable à FilterStatus.

Dans ce cas, le pilote de filtre doit définir le membre SourceHandle sur le handle que NDIS a passé au paramètre NdisFilterHandle de la fonction FilterAttach. Si l’indication d’état est associée à une requête OID, le pilote de filtre peut définir les membres DestinationHandle et RequestId afin que NDIS puisse fournir l’indication d’état à une liaison de protocole spécifique.

Après qu’un pilote de filtre a appelé NdisFIndicateStatus, NDIS appelle la fonction d’état (ProtocolStatusEx ou FilterStatus) du pilote supérieur suivant.