Filtrowanie wskazówek dotyczących stanu modułu

Sterowniki filtrów mogą dostarczać funkcję FilterStatus wywoływaną przez NDIS, gdy podstawowy sterownik zgłasza stan. Sterowniki filtrów mogą również inicjować wskazania stanu.

Na poniższym rysunku przedstawiono przefiltrowany wskaźnik stanu.

NDIS wywołuje funkcję FilterStatus sterownika filtru po wywołaniu funkcji wskazywania stanu przez sterownik bazowy (NdisMIndicateStatusEx lub NdisFIndicateStatus). Aby uzyskać więcej informacji na temat wskazywania stanu ze sterownika miniportu, zobacz Wskaźniki stanu adaptera.

Sterownik filtru wywołuje NdisFIndicateStatus w funkcji FilterStatus w celu przekazania przefiltrowanego wskaźnika stanu do nadrzędnych sterowników. Sterownik filtru może odfiltrować wskazania stanu (nie wywołując NdisFIndicateStatus) lub zmodyfikować wskazany stan przed wywołaniem NdisFIndicateStatus.

Aby zainicjować wskazania statusu, sterowniki filtru wywołują NdisFIndicateStatus bez wcześniejszego wywołania FilterStatus.

W takim przypadku sterownik filtru powinien ustawić element członkowski SourceHandle na dojście, które NDIS przekazuje w parametrze NdisFilterHandle funkcji FilterAttach. Jeśli wskazanie stanu jest skojarzone z żądaniem OID, sterownik filtru może ustawić elementy członkowskie DestinationHandle i RequestId, aby usługa NDIS mogła zapewnić wskazanie stanu dla określonego powiązania protokołu.

Po tym, jak sterownik filtru wywoła NdisFIndicateStatus, NDIS wywołuje funkcję statusu (ProtocolStatusEx lub FilterStatus) następnego sterownika wyższego poziomu.